Skip to content
statance
MenuClose

Notifications

Recipients and notification channels: config keys for email, Slack, Discord, Teams, Telegram, PagerDuty, webhooks 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

KeyChannelValuePlan
emailEmailEmail addressAll
slackURLSlackSlack incoming webhook URLAll
discordURLDiscordDiscord webhook URLAll
msteamsURLMicrosoft TeamsTeams workflow webhook URLPro
googleChatURLGoogle ChatGoogle Chat webhook URLPro
telegramChatIdTelegramTelegram chat IDAll
pushoverKeyPushoverPushover user keyPro
pushbulletTokenPushbulletPushbullet access tokenPro
pagerdutyKeyPagerDutyPagerDuty Events v2 routing keyPro
webhookURLWebhooksHTTPS URL receiving JSON POSTsAll
ntfyTopicntfyTopic on ntfy.sh or full URLAll
pushoverTokenPushoverPushover app API token (required with pushoverKey)Pro

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 →