Skip to main content

​
Overview

The List Alert Channels endpoint returns all alert channels configured in your Checkly account. Alert channels define how and where you receive notifications when your checks fail or recover.
Alert channels can be of different types: EMAIL, WEBHOOK, SLACK, SMS, or PHONE. Each type has its own configuration requirements.

​
Response Example

{
  "data": [
    {
      "id": 123,
      "type": "EMAIL",
      "name": "Team Alerts",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-20T14:45:00.000Z",
      "config": {
        "address": "alerts@company.com"
      }
    },
    {
      "id": 124,
      "type": "SLACK",
      "name": "Engineering Channel",
      "createdAt": "2024-01-10T08:15:00.000Z",
      "updatedAt": "2024-01-18T16:20:00.000Z",
      "config": {
        "url": "https://hooks.slack.com/services/...",
        "channel": "#monitoring"
      }
    },
    {
      "id": 125,
      "type": "WEBHOOK",
      "name": "PagerDuty Integration",
      "createdAt": "2024-01-12T12:00:00.000Z",
      "updatedAt": "2024-01-19T09:30:00.000Z",
      "config": {
        "url": "https://events.pagerduty.com/integration/...",
        "method": "POST",
        "headers": [
          {
            "key": "Authorization",
            "value": "Token token=..."
          }
        ]
      }
    }
  ],
  "meta": {
    "currentPage": 1,
    "totalPages": 1,
    "totalItems": 3,
    "limit": 10
  }
}

​
Alert Channel Types

Sends notifications via email to specified addresses.Configuration:
  • address (string): Email address to send alerts to
Example:
{
  "type": "EMAIL",
  "name": "Team Email Alerts",
  "config": {
    "address": "team@company.com"
  }
}
Sends notifications to Slack channels via webhooks.Configuration:
  • url (string): Slack webhook URL
  • channel (string, optional): Slack channel name
Example:
{
  "type": "SLACK",
  "name": "Engineering Slack",
  "config": {
    "url": "https://hooks.slack.com/services/...",
    "channel": "#alerts"
  }
}
Sends HTTP requests to custom endpoints.Configuration:
  • url (string): Webhook endpoint URL
  • method (string): HTTP method (GET, POST, PUT, etc.)
  • headers (array, optional): Custom headers
  • queryParameters (array, optional): Query parameters
Example:
{
  "type": "WEBHOOK",
  "name": "Custom Integration",
  "config": {
    "url": "https://api.example.com/alerts",
    "method": "POST",
    "headers": [
      {
        "key": "Authorization",
        "value": "Bearer token123"
      }
    ]
  }
}
Sends text message notifications to phone numbers.Configuration:
  • number (string): Phone number in international format
  • name (string): Display name for the SMS alert
Example:
{
  "type": "SMS",
  "name": "On-call SMS",
  "config": {
    "number": "+1234567890",
    "name": "Emergency Alerts"
  }
}
Makes phone calls for critical alerts.Configuration:
  • number (string): Phone number in international format
  • name (string): Display name for the phone alert
Example:
{
  "type": "PHONE",
  "name": "Critical Phone Alerts",
  "config": {
    "number": "+1234567890",
    "name": "Emergency Line"
  }
}

​
Use Cases

Team Notifications

Set up email or Slack alerts to keep your team informed about check failures

Escalation Chains

Configure SMS and phone alerts for critical checks that require immediate attention

Integration Webhooks

Connect to external systems like PagerDuty, OpsGenie, or custom incident management tools

Multi-Channel Strategy

Combine multiple alert types for comprehensive coverage based on severity and time of day

​
Additional Examples

curl -X GET "https://api.checklyhq.com/v1/alert-channels" \
  -H "Authorization: Bearer cu_1234567890abcdef" \
  -H "X-Checkly-Account: 550e8400-e29b-41d4-a716-446655440000"
Alert channels are shared across your entire account. When you create a check, you can subscribe it to one or more alert channels to receive notifications when that specific check fails or recovers.