Sign in

v2

latestOpenAPI 3.0.02026-07-261859071.2 MB
Alert channels

Create an alert channel

Creates a new alert channel

post/v1/alert-channels

Headers

x-checkly-accountstring

Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

Request body

type'EMAIL' | 'SLACK' | 'SLACK_APP' | 'WEBHOOK' | 'SMS' | 'PAGERDUTY' | 'OPSGENIE' | 'CALL' required
configAlertChannelCreateConfig required
sendRecoveryboolean
sendFailureboolean
sendDegradedboolean
sslExpiryboolean

Determines if an alert should be sent for expiring SSL certificates.

sslExpiryThresholdinteger

At what moment in time to start alerting on SSL certificates.

autoSubscribeboolean

Automatically subscribe newly created checks to this alert channel.

Example request

{
  "subscriptions": [],
  "type": "SMS"
}

Response

Created

idnumber required
type'EMAIL' | 'SLACK' | 'SLACK_APP' | 'WEBHOOK' | 'SMS' | 'PAGERDUTY' | 'OPSGENIE' | 'CALL' required
configAlertChannelConfig required

The configuration details for this alert channel. These can be very different based on the type of the channel.

sendRecoveryboolean
sendFailureboolean
sendDegradedboolean
sslExpiryboolean

Determines if an alert should be sent for expiring SSL certificates.

sslExpiryThresholdinteger

At what moment in time to start alerting on SSL certificates.

autoSubscribeboolean

Automatically subscribe newly created checks to this alert channel.

created_atstring date-time
updated_atstring date-time nullable

Example response

{
  "id": 1,
  "type": "SMS",
  "subscriptions": []
}