v51

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01206322659.2 KB
channels

Create a delivery channel

Create a delivery channel for this org, or reuse an existing one.

Channels dedupe on (type, config): posting the same Slack channel twice returns the original row with channel_action: "reused" rather than creating a near-duplicate. Attach the returned id to an alarm via POST /orgs/{org_id}/alarms/{alarm_id}/channels.

post/orgs/{org_id}/channels

Path parameters

org_idstring required

Request body

configobject
namestring nullable
type'email' | 'slack'

Response

Channel created or reused

channel_action'linked' | 'reused' | 'created' required

How the request was wired to NotificationChannels.

idinteger required