Create channel

curl --request POST \
  --url https://api.timbal.ai/orgs/{org_id}/notifications/channels \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "email",
  "name": "Finance inbox",
  "config": {
    "to": "finance@example.com"
  }
}
'

{
  "id": 123
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

POST

orgs

{org_id}

notifications

channels

curl --request POST \
  --url https://api.timbal.ai/orgs/{org_id}/notifications/channels \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "email",
  "name": "Finance inbox",
  "config": {
    "to": "finance@example.com"
  }
}
'

{
  "id": 123
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

Creates or reuses a channel (e.g. email dedupe by type + config). Org admin only.

Authorizations

Authorization

string

header

required

Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.

Path Parameters

org_id

string

required

Body

application/json

Body for POST /orgs/{org_id}/notifications/channels (standalone channel; same validation as inline rule channel, no id).

config

object

name

string | null

type

enum<string>

Available options:

email,

slack

Response

Channel created

channel_action

enum<string>

required

How the rule was wired to NotificationChannels for this create call.

Available options:

linked,

reused,

created

integer<int64>

required

List channels Delete channel