Skip to main content
POST
Create a destination

Authorizations

Authorization
string
header
required

Organization API key (sl_…).

Headers

x-tenant-id
string
required

The organization ID the request is scoped to.

Body

application/json

Request body to create a Slack alert destination.

integration_id
string
required

Opaque identifier of the alert integration this destination sends through. Its integration_type must match the destination's. Set when the destination is created and immutable afterward.

integration_type
string
required

The kind of destination, matching the integration_type of its alert integration. Determines which settings the destination carries. Set when the destination is created and immutable afterward.

Allowed value: "slack"
channel
string
required

Name of the Slack channel alerts are posted to, without the leading #. The SELECT app must be added to a private channel before alerts can be delivered to it.

Minimum string length: 1

Response

Successful Response

An alert destination that posts to a Slack channel.

id
string
required
read-only

Opaque identifier for this destination. Set when the destination is created and immutable afterward.

etag
string
required
read-only

Opaque strong ETag for this destination's configuration. Matches the ETag response header, and is what If-Match requires on a write. It changes whenever a configurable field on the destination changes.

integration_id
string
required

Opaque identifier of the alert integration this destination sends through. Its integration_type must match the destination's. Set when the destination is created and immutable afterward.

status
enum<string>
required
read-only

Current delivery status of this destination: connected after a successful delivery or test message, failing after a failed one, and unknown before either has happened.

Available options:
unknown,
pending,
failing,
connected
create_time
string
required
read-only

When the destination was created, as an RFC 3339 UTC timestamp.

update_time
string
required
read-only

When the destination was last changed, as an RFC 3339 UTC timestamp.

integration_type
string
required

The kind of destination, matching the integration_type of its alert integration. Determines which settings the destination carries. Set when the destination is created and immutable afterward.

Allowed value: "slack"
channel
string
required

Name of the Slack channel alerts are posted to, without the leading #. The SELECT app must be added to a private channel before alerts can be delivered to it.

error_message
string | null

Why the most recent delivery to this destination failed. Null unless status is failing.

last_used_time
string | null

When this destination last sent an alert, as an RFC 3339 UTC timestamp. Null if it has not sent one yet.