Get started

palmpush lets your tools send push notifications to your iPhone.

Create a listener in the iOS app, copy its send URL, and call that URL from a script, automation, backend job, or AI agent.

1. Create a listener

Open the palmpush iOS app, allow notifications, and tap Create new.

Give the listener a name that matches the tool or project that will send notifications, for example Deployments or AI agent.

2. Copy the send URL

Tap Copy URL on the listener.

The URL looks like this:

txt

https://push.palmpush.com/send/<listener-token>

The token in the URL is the secret. Anyone with it can send notifications to that listener.

3. Send a test push

bash

curl -X POST "https://push.palmpush.com/send/<listener-token>" \
  -H "Content-Type: application/json" \
  -d '{"title":"Build finished","body":"Ready to ship."}'

The first version supports a short title and a body. That is enough for status updates, failed jobs, approvals, and small alerts.

Next steps

Use Send notifications for HTTP and JavaScript examples.
Use PWA setup when a web app should receive palmpush notifications.
Use AI agents when an MCP client should notify you.
Read Concepts for listener tokens, devices, history, and security.