Notification destinations

Create a notification destination

Creates a notification destination (Slack or email). Requires notification:manage. slack requires webhook_url; email requires config.to. Verify delivery with POST /notification-destination/{id}/test before relying on it.

post/notification-destination

Request

  • Base URL: https://api.elaichi.ai
  • URL: https://api.elaichi.ai/notification-destination
  • Auth: HTTP bearer

Headers

X-Organization-Idstring

Target organization (org_…). Required for cookie/session auth on org-scoped routes; optional for API tokens, which carry their organization, and rejected when it names a different one.

Request body

type'slack' | 'email' required

Immutable after creation.

namestring required
is_activeboolean
webhook_urlstring

Slack incoming-webhook URL. Ignored for type: "email".

event_typesstring[]

Response

Created

idstring

Notification destination id (onfd_…).

type'slack' | 'email'

Immutable after creation.

namestring
is_activeboolean

Paused destinations keep their config but forward nothing.

event_typesstring[]

Fixed catalog of org events this destination is subscribed to.

last_test_atstring date-time nullable
last_test_status'ok' | 'failed' | 'null' nullable
created_by_user_idstring nullable
created_atstring date-time
updated_atstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.