Skip to main content

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.

Product model​

Pushmark is built around three pieces:

  • Your account on pushmark.app
  • Public channels that group notifications by use case
  • A channel hash that lets scripts and services post into that channel
  • An MCP endpoint that lets AI agents use Pushmark as a structured tool

The common flow is simple:

  1. Sign in to the dashboard.
  2. Create a public channel for a workflow like deployments, alerts, or personal-reminders.
  3. Copy that channel's hash from the channel page.
  4. Send JSON to https://api.pushmark.app/<channel_hash>.
  5. 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.

Quick start​

1. Create a channel​

Open the dashboard and create a public channel for the notifications you want to send. Separate channels make it easier to manage delivery and keep unrelated alerts apart.

2. Copy the channel hash​

Each public channel has a hash you can use as part of the request URL. You will find it in the channel page together with ready-to-use examples and a QR code for subscription.

3. 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.",
    "type": "success"
  }'

If the request is accepted, the notification should appear in the iPhone app for subscribers of that channel.

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