Notifications

Recipients and notification channels: config keys for email, Slack, Discord, Teams, Telegram, PagerDuty, SMS and more.

A recipient (API: channel) has a name and a config object holding one or more targets. When a recipient is notified, every target it contains receives the alert.

Config keys

Key	Channel	Value	Plan
`email`	Email	Email address	All
`slackURL`	Slack	Slack incoming webhook URL	All
`discordURL`	Discord	Discord webhook URL	All
`msteamsURL`	Microsoft Teams	Teams workflow webhook URL	Pro
`googleChatURL`	Google Chat	Google Chat webhook URL	Pro
`telegramChatId`	Telegram	Telegram chat ID	All
`pushoverKey`	Pushover	Pushover user key	Pro
`pushbulletToken`	Pushbullet	Pushbullet access token	Pro
`pagerdutyKey`	PagerDuty	PagerDuty Events v2 routing key	Pro
`webhookURL`	Webhooks	HTTPS URL receiving JSON POSTs	All
`ntfyTopic`	ntfy	Topic on ntfy.sh or full URL	All
`phoneNumberSMS`	SMS	E.164 phone number	Business
`phoneNumberVoice`	Voice calls	E.164 phone number	Business

Example

curl -X POST https://api.statance.com/v1/channels \
  -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name":"On-call","config":{"email":"oncall@example.com",
       "slackURL":"https://hooks.slack.com/services/T000/B000/XXXX",
       "pagerdutyKey":"R0UT1NGK3Y"}}'

# Send a test notification
curl -X POST https://api.statance.com/v1/channels/CHANNEL_ID/test \
  -H "Authorization: Bearer YOUR_API_KEY"

Webhook payload

Webhook targets receive a JSON POST — see the webhooks page for the shape.

Next: Heartbeats →