# SmsAlertChannel Construct - Checkly Docs

> Learn how to configure SMS alert channels with the Checkly CLI.

Source: https://www.checklyhq.com/docs/constructs/sms-alert-channel/

---

Back to top
- Configuration SMS alert channel options
- General alert channel options

Alert Channels

# SmsAlertChannel Construct

Learn how to configure SMS alert channels with the Checkly CLI.

For general information about alerting, see our docs on [SMS alerts](https://www.checklyhq.com/docs/integrations/alerts/sms) and [alerting with Checkly](https://www.checklyhq.com/docs/communicate/alerts/overview/).

Use SMS alert channels to send SMS notifications to phone numbers when checks fail or recover.

```
import { SmsAlertChannel } from 'checkly/constructs'

const smsChannel = new SmsAlertChannel('sms-channel-1', {
name: 'Ops on-call',
phoneNumber: '+31061234567890',
})
```

```
import { SmsAlertChannel } from 'checkly/constructs'

const smsChannel = new SmsAlertChannel('sms-channel-1', {
name: 'Ops on-call',
phoneNumber: '+31061234567890',
sendRecovery: true,
sendFailure: true,
sendDegraded: false,
sslExpiry: true,
sslExpiryThreshold: 7,
})
```

If you need to reference existing alert channels that were created outside of your CLI project, use [`fromId()`](https://www.checklyhq.com/docs/constructs/alert-channel#using-fromid-to-reference-an-existing-channel).

## Configuration

### SMS alert channel options

string

required

Phone number to send SMS notifications to. Each `SmsAlertChannel` supports only one phone number. Phone numbers need to be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164). We only support phone numbers from certain [countries and regions](https://www.checklyhq.com/docs/integrations/alerts/sms#supported-countries-and-regions).

```
new SmsAlertChannel('sms-channel-1', {
name: 'Ops on-call',
phoneNumber: '+31061234567890',
})
```

string

Friendly name for the SMS alert channel.

### General alert channel options

These options are valid for all alert channels types.
boolean

Whether to send notifications when checks recover from a [failed or degraded state](https://www.checklyhq.com/docs/communicate/alerts/overview/#alert-channels). Default value is `true`.

boolean

Whether to send notifications when checks [fail](https://www.checklyhq.com/docs/communicate/alerts/overview/#alert-channels). Default value is `true`.

boolean

Whether to send notifications when checks [become degraded](https://www.checklyhq.com/docs/communicate/alerts/overview/#alert-channels). Default value is `false`.

boolean

Whether to send notifications when a SSL/TLS certificate is about to expire. Default value is `false`.

```
new EmailAlertChannel("email-channel-1", {
address: "alerts@acme.com",
sslExpiry: true,
sslExpiryThreshold: 30, // Alert 30 days before expiry
})
```

[Learn more about SSL alerts.](https://www.checklyhq.com/docs/communicate/alerts/ssl-expiration/)

number

Number of days before the SSL/TLS certificate expiry date to send notifications. Only relevant when `sslExpiry` is enabled. Default value is `30`.

```
new EmailAlertChannel("email-channel-1", {
address: "alerts@acme.com",
sslExpiry: true,
sslExpiryThreshold: 30, // Alert 30 days before expiry
})
```

[Learn more about SSL alerts.](https://www.checklyhq.com/docs/communicate/alerts/ssl-expiration/)

Was this page helpful?

[Suggest edits](https://github.com/checkly/docs/edit/main/constructs/sms-alert-channel.mdx)[Raise issue](https://github.com/checkly/docs/issues/new?title=Issue%20on%20docs&body=Path:%20/constructs/sms-alert-channel)

[EmailAlertChannel Construct Previous](https://www.checklyhq.com/docs/constructs/email-alert-channel)[PhoneCallAlertChannel Construct Next](https://www.checklyhq.com/docs/constructs/phone-call-alert-channel)

[x](https://x.com/checklyhq)[github](https://github.com/checkly)[linkedin](https://linkedin.com/company/checkly)

[Powered by This documentation is built and hosted on Mintlify, a developer documentation platform](https://www.mintlify.com/?utm_campaign=poweredBy&utm_medium=referral&utm_source=checkly-422f444a)
