Skip to main content

Channels

A channel is an Alerta-managed reference to a provider destination. Alert requests use channel information so sending systems do not need raw provider identifiers.

Dashboard Source Of Truth​

Find connected channels in the Alerta dashboard after connecting Slack, Discord, or Microsoft Teams.

Channel Usage In Requests​

POST /v2/discord/send

Discord alert requests use channelRef.

{
  "channelRef": "C_ALT_ABC123",
  "message": "Database replication lag exceeded threshold."
}

POST /v2/teams/send

Microsoft Teams alert requests use channelRef.

{
  "channelRef": "C_ALT_TEAMS123",
  "title": "Database Alert",
  "message": "Database replication lag exceeded threshold."
}

POST /v2/slack/send

Slack send requests use channel.

{
  "channel": "alerts",
  "message": "Database replication lag exceeded threshold."
}

Notes​

  • Channel references belong to the organization that created them.
  • If an API request fails with an invalid channel error, confirm the channel still appears in the dashboard.
  • Do not hard-code provider IDs unless a provider-specific endpoint explicitly requires them.