Get started
Send messages from scripts, automations, backend jobs, or AI agents to your iPhone. Create a listener for each source, then send a message to its URL.
You do not need an account. These guides describe the palmpush iOS app version 1.1 and the HTTP API. JavaScript, MCP, and PWA packages have their own versions.
Working with an AI agent? Share our LLM documentation for setup instructions and examples.
1. Create a listener
Open palmpush on your iPhone
and tap Create new. Name the listener after its source, such as Deployments
or AI agent.
Notification permission is optional. Choose Enable Push Notifications to receive iOS alerts, or Explore without notifications to use listeners and History first. You can manage permission later using Manage in the app.
2. Copy the send URL
Open the listener menu and tap Copy URL. It looks like this:
https://push.palmpush.com/send/<listener-token>Treat this URL like a secret. Anyone with its token can send to the listener, subscribe another device, and change listener settings.
3. Send a message
On your computer, replace <listener-token> with the token in the copied URL:
curl -X POST "https://push.palmpush.com/send/<listener-token>" \
-H "Content-Type: application/json" \
-d '{"title":"Build finished","body":"Ready to ship."}'Keep listener enabled on while testing. It is on by default.
If you prefer a form, open the palmpush website, expand Send a real push, and paste the URL or token. The demo sends text; use the HTTP API for images and links.
4. Check the result
Open the listener menu, tap History, then Refresh. Your title and body appear there even if iOS notification permission is off.
With permission enabled, iOS can also show an alert. Without a link, tapping a
new notification opens its matching History entry. A Sent status means a push
provider accepted the request; it does not confirm that an alert appeared.
Next steps
- Listeners and History: names, avatars, devices, and settings.
- HTTP API: fields, examples, responses, and limits.
- Images: attach an image using
imageUrl. - Links and tap actions: open a website or supported app using
url. - JavaScript and AI agents: connect your code or MCP client.
- PWA setup: receive notifications in your own web app.
- Troubleshooting: check missing alerts, images, or failed requests.