Pushmark docs

Pushmark gives you a fast way to send a notification from code or an AI agent and have it appear in the iPhone app almost immediately.

Build delivery flows for deployments, cron jobs, personal reminders, and production alerts without standing up a full notification platform.

How it works

1. Create a channel — in the dashboard or directly in the Pushmark app.
2. Copy the channel's hash from its channel page.
3. Send a message to https://api.pushmark.app/<channel_hash>.
4. Receive the notification in the Pushmark iPhone app.

If you are working with Codex, Cursor, Claude Code, or another MCP-compatible client, you can also connect Pushmark over MCP and let the agent send notifications or inspect channels through tool calls.

Send a test notification

curl -X POST https://api.pushmark.app/YOUR_CHANNEL_HASH \
  -H "Content-Type: application/json" \
  -d '{ "message": "Backup finished in 4m 12s." }'

If the request is accepted, the notification appears in the app for everyone who joined that channel in the Pushmark app.

What to read next

• Go to Send a Notification for the basic request and code examples.
• Go to Notification Configuration for types, titles, images, and structured JSON.
• Go to Channels for how channels work and how devices subscribe.
• Go to AI Agents and MCP for agent integration and MCP examples.

Recommended use cases

• Deploy and CI/CD alerts
• Personal automation and reminders
• Cron job completion messages
• Error and uptime monitoring
• Internal workflow notifications