Skip to content

Publish your first alert

Once you have created a channel and copied its publishing key, send a JSON payload to the notification API.

Terminal window
curl -X POST https://api.bells.sh/v1/notify \
-H "Authorization: Bearer $BELLS_KEY" \
-H "Content-Type: application/json" \
-d '{"channel":"deploys","title":"Production is live","priority":"high"}'

A successful request returns 202 Accepted after the notification event and its delivery work have been stored durably.

  • Pair a mobile device or enable browser notifications on desktop.
  • Add an idempotency key to safely retry a publish request.
  • Create a routing rule for high-priority notifications.