Features
One event. The right channel.
Boson stores the notification, routes it through a registered channel handler, and delivers in-app over a WebSocket. Email, SMS, and push use the same event once a provider is configured.
Channels
The API accepts all four. Delivery depends on the channel.
Handlers, not a fork
The worker keeps a registry of channel handlers. An event names a channel, the worker looks up that handler, and the handler delivers. In-app writes the inbox and publishes on Redis for the WebSocket. Email, SMS, and push call their provider when credentials are present.
Send an event
Every route except health expects the workspace key in the x-api-key header. This example writes an in-app notification.
curl -X POST https://api.getboson.com/v1/events \
-H "content-type: application/json" \
-H "x-api-key: $BOSON_API_KEY" \
-d '{
"channel": "in_app",
"subscriberId": "user_123",
"title": "Deploy finished",
"body": "api-7f3c is live"
}'