Skip to documentation content

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:

text
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:

bash
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