Skip to main content
POST
Create a notification destination

Authorizations

Authorization
string
header
required

Supabase JWT token in Authorization: Bearer header

Path Parameters

org_id
string
required

Organization identifier (e.g. org-abc12345)

Body

application/json
channel
enum<string>
required

Delivery channel for this destination: webhook, slack, email, or pagerduty.

Available options:
webhook,
slack,
email,
pagerduty
config
object
required

Channel-specific delivery settings (e.g. webhook { url, secret }, slack { webhook_url }, email { to }, pagerduty { routing_key }).

filter
object

Optional filter limiting which signals reach this destination (by source, severity, scope, or pattern_type); omit to receive all.

enabled
boolean
default:true

Whether the destination is active and eligible to receive dispatches (default true).

display_name
string

Optional human-readable label shown in the operator console.

Response

Notification destination.

id
string<uuid>
required
org_id
string
required
channel
enum<string>
required
Available options:
webhook,
slack,
email,
pagerduty
config
object
required
filter
object
required
enabled
boolean
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
display_name
string | null
created_by
string<uuid> | null
last_tested_at
string<date-time> | null
last_test_status
enum<string> | null
Available options:
ok,
failed
last_test_error
string | null