Skip to content

HTTP API

POST https://api.bells.sh/v1/notify

Header Required Description
Authorization Yes A bearer publishing key scoped to the channel.
Content-Type Yes Use application/json.
Idempotency-Key Recommended Makes retried publish requests safe.
{
"channel": "deploys",
"title": "Production is live",
"message": "Version 2.4.0 is healthy in all regions.",
"priority": "high"
}

202 Accepted means Bells has committed the notification and its delivery jobs. It does not claim that an end device has displayed the notification.