From a0cc187802b09a752bfa4def6e1c667c685aad38 Mon Sep 17 00:00:00 2001 From: Hannes Lenke Date: Sun, 8 Nov 2026 06:59:46 -0500 Subject: [PATCH 1/6] docs(alerts): explain SMS and phone call quotas, test limits and failed alerts Co-Authored-By: Claude Opus 5.5 --- integrations/alerts/phone-calls.mdx | 12 +++++++++++- integrations/alerts/sms.mdx | 26 ++++++++++++++++++++++++++ 2 files changed, 37 insertions(+), 1 deletion(-) diff --git a/integrations/alerts/phone-calls.mdx b/integrations/alerts/phone-calls.mdx index 28d8381b4..ad54d5895 100644 --- a/integrations/alerts/phone-calls.mdx +++ b/integrations/alerts/phone-calls.mdx @@ -17,7 +17,9 @@ The phone numbers used for phone call alerting need to be in [E.164 format](http ![send monitoring alerts with phone calls](/images/docs/images/alerting/phone-call.png) -You can add as many phone number channels as you like. Phone call channels aren't available on the Hobby and Starter plans, and some countries are only available on paid plans, not during a trial. +You can add as many phone number channels as you like. Phone call alerts are included on the Team plan and above. On the Hobby plan, you can't create phone call channels. On the Starter plan, you can create and test a phone call channel, but its alerts aren't sent, see [Monthly phone call quota](#monthly-phone-call-quota). + +Some countries are only available on paid plans, not during a trial: the same countries as for SMS alerts. Numbers are checked the same way as for SMS alerts, see [SMS supported countries and regions](/integrations/alerts/sms#supported-countries-and-regions) for the messages. For a phone call channel, the web app shows `Calls to this country require a paid plan. Upgrade your plan to use this number.` for a paid-only country. ## Supported countries and regions @@ -83,4 +85,12 @@ If your country is not supported feel free to reach out to our [support team](ma Phone call alerts always use the following number: +18142508623. You can save the number as a contact to allow alerts bypassing any do-not-disturb settings. +## Monthly phone call quota + +Each phone call alert that Checkly sends to a channel counts against your account's monthly phone call quota. All phone call channels in your account share the quota, and it starts again at the beginning of each calendar month. See the [Pricing page](https://www.checklyhq.com/pricing/#features) for the quota of each plan. Test calls don't count against the quota. + +When your account has used its quota, or your plan includes no phone calls, Checkly doesn't send the call. The alert appears in the [alert notification log](/communicate/alerts/notification-log) with the delivery status **Failed** and the notification result `Account hit the monthly CALL limit`. + +Accounts on a trial can send only a few test calls a day. When you reach that limit, the **Test alert channel** button shows how many seconds to wait. + For limits and other phone call related questions, please refer to our [Pricing page](https://www.checklyhq.com/pricing/#features). diff --git a/integrations/alerts/sms.mdx b/integrations/alerts/sms.mdx index 5eaf16e2c..31a78c054 100644 --- a/integrations/alerts/sms.mdx +++ b/integrations/alerts/sms.mdx @@ -23,6 +23,15 @@ You can add as many SMS channels as you like. SMS channels aren't available on t SMS alerts can only be sent to phone numbers in the following countries. Numbers from other countries are rejected when you create or update the channel. +When a number is rejected, the channel form or the API tells you why: + +| Message | What to do | +| ------ | ------ | +| `The number field must be a valid phone number` (web app) or `phoneNumber is not a valid phone number` (API) | Enter the number in E.164 format: a `+`, the country code and the number, without spaces or dashes. | +| `Invalid country code. Please see our documentation for a full list of supported countries` | Start the number with `+` and the country code, and use a country from the table below. | +| `SMS to this country requires a paid plan. Upgrade your plan to use this number.` (web app) or `SMS and phone call alerts to this country are only available on a paid plan. Upgrade your plan to use this number.` (API) | The country is available on paid plans only, not on trials. | +| `Adding or changing SMS and phone call alert channels requires the Starter plan or above.` (API) | Your account is on the Hobby plan, which doesn't include SMS alerts. | + | Country | Availability | | ------ | ------ | | Argentina (+54) | Paid plans only, not on trials | @@ -81,4 +90,21 @@ SMS alerts can only be sent to phone numbers in the following countries. Numbers SMS alerts will be sent with a sender ID and phone number. The Checkly sender ID is 'Checkly'. If your carrier does not support sender ID, you will instead see the Checkly SMS alert phone number, +1(814) 250 8623. +## Monthly SMS quota + +Each SMS alert that Checkly sends to a channel counts against your account's monthly SMS quota. All SMS channels in your account share the quota, and it starts again at the beginning of each calendar month. See the [Pricing page](https://www.checklyhq.com/pricing/#features) for the quota of each plan. Test messages don't count against the quota. + +When your account has used its quota, Checkly doesn't send SMS alerts for the rest of the month. Each alert that isn't sent appears in the [alert notification log](/communicate/alerts/notification-log) with the delivery status **Failed** and the notification result `Account hit the monthly SMS limit`. SMS alerts are sent again from the next calendar month. + +## Test messages + +Click **Test alert channel** in the channel form to send a test SMS to the number before you save the channel. Accounts on a trial or the Hobby plan can send only a few test messages a day. When you reach that limit, the button shows how many seconds to wait, and the API responds with `429 Too Many Requests` and `Alert channel test rate limit exceeded`. + +## Troubleshooting a missing SMS alert + +Open the [alert notification log](/communicate/alerts/notification-log), select your SMS channel and check **Show failures only**. Select a failed notification to see its notification result: + +- `Account hit the monthly SMS limit`: your account used its monthly SMS quota. See [Monthly SMS quota](#monthly-sms-quota). +- Any other result: the message didn't reach the number through our SMS provider. Check that the number is correct and can receive SMS, then send a test message. If alerts to a correct number keep failing, contact [support](mailto:support@checklyhq.com). + For limits and other SMS-related questions, please refer to our [Pricing page](https://www.checklyhq.com/pricing/#features). From 49a85af43175d28b44c692f9a7db10adbe24ab48 Mon Sep 17 00:00:00 2001 From: Hannes Lenke Date: Sun, 8 Nov 2026 19:30:40 -0500 Subject: [PATCH 2/6] docs(alerts): list SMS and call failure reasons, test-limit reset, more quota Lists the specific notification results for failed SMS and phone call alerts with a fix for each, says the trial/Hobby test limit resets after 24 hours, and adds a contact-support line for more SMS or calls. Co-Authored-By: Claude Opus 5.5 --- integrations/alerts/phone-calls.mdx | 12 +++++++++++- integrations/alerts/sms.mdx | 12 ++++++++++-- 2 files changed, 21 insertions(+), 3 deletions(-) diff --git a/integrations/alerts/phone-calls.mdx b/integrations/alerts/phone-calls.mdx index ad54d5895..cc8310a21 100644 --- a/integrations/alerts/phone-calls.mdx +++ b/integrations/alerts/phone-calls.mdx @@ -91,6 +91,16 @@ Each phone call alert that Checkly sends to a channel counts against your accoun When your account has used its quota, or your plan includes no phone calls, Checkly doesn't send the call. The alert appears in the [alert notification log](/communicate/alerts/notification-log) with the delivery status **Failed** and the notification result `Account hit the monthly CALL limit`. -Accounts on a trial can send only a few test calls a day. When you reach that limit, the **Test alert channel** button shows how many seconds to wait. +Accounts on a trial can send only a few test calls a day. The limit resets after 24 hours. When you reach that limit, the **Test alert channel** button shows how many seconds to wait. + +Need more SMS or phone calls? Contact [support](mailto:support@checklyhq.com). + +## Troubleshooting a missing phone call alert + +Open the [alert notification log](/communicate/alerts/notification-log), select your phone call channel and check **Show failures only**. Select a failed notification to see its notification result: + +- `Account hit the monthly CALL limit`: your account used its monthly phone call quota, or your plan includes no phone calls. See [Monthly phone call quota](#monthly-phone-call-quota). +- `Incomplete alert channel config`: the channel has no phone number. Edit the channel and add one. +- `Failed to send the Call`: the call couldn't be started through our phone call provider. Check that the number is correct, then select **Test alert channel** to place a test call. If alerts to a correct number keep failing, contact [support](mailto:support@checklyhq.com). For limits and other phone call related questions, please refer to our [Pricing page](https://www.checklyhq.com/pricing/#features). diff --git a/integrations/alerts/sms.mdx b/integrations/alerts/sms.mdx index 31a78c054..a8739ac8f 100644 --- a/integrations/alerts/sms.mdx +++ b/integrations/alerts/sms.mdx @@ -96,15 +96,23 @@ Each SMS alert that Checkly sends to a channel counts against your account's mon When your account has used its quota, Checkly doesn't send SMS alerts for the rest of the month. Each alert that isn't sent appears in the [alert notification log](/communicate/alerts/notification-log) with the delivery status **Failed** and the notification result `Account hit the monthly SMS limit`. SMS alerts are sent again from the next calendar month. +Need more SMS or phone calls? Contact [support](mailto:support@checklyhq.com). + ## Test messages -Click **Test alert channel** in the channel form to send a test SMS to the number before you save the channel. Accounts on a trial or the Hobby plan can send only a few test messages a day. When you reach that limit, the button shows how many seconds to wait, and the API responds with `429 Too Many Requests` and `Alert channel test rate limit exceeded`. +Click **Test alert channel** in the channel form to send a test SMS to the number before you save the channel. Accounts on a trial or the Hobby plan can send only a few test messages a day. The limit resets after 24 hours. When you reach that limit, the button shows how many seconds to wait, and the API responds with `429 Too Many Requests` and `Alert channel test rate limit exceeded`. ## Troubleshooting a missing SMS alert Open the [alert notification log](/communicate/alerts/notification-log), select your SMS channel and check **Show failures only**. Select a failed notification to see its notification result: - `Account hit the monthly SMS limit`: your account used its monthly SMS quota. See [Monthly SMS quota](#monthly-sms-quota). -- Any other result: the message didn't reach the number through our SMS provider. Check that the number is correct and can receive SMS, then send a test message. If alerts to a correct number keep failing, contact [support](mailto:support@checklyhq.com). +- `Invalid phone number`: our SMS provider doesn't accept the number. Check the number and its country code, then send a test message. +- `Phone number doesn't support SMS`: the number can't receive SMS, for example because it's a landline. Use a mobile number. +- `Region not enabled`: SMS to the number's country or region can't be sent. Contact [support](mailto:support@checklyhq.com). +- `Attempt to send to unsubscribed recipient`: the number opted out of messages from Checkly, for example by replying `STOP`. To opt back in, reply `START` from that phone to the Checkly SMS number, see [SMS alert number and sender ID](#sms-alert-number-and-sender-id). +- `Incomplete alert channel config`: the channel has no phone number. Edit the channel and add one. +- `FROM number not associated with Twilio account`: a problem with the number Checkly sends from. Contact [support](mailto:support@checklyhq.com). +- `Failed to send the SMS`: the message didn't reach the number through our SMS provider. Check that the number is correct and can receive SMS, then send a test message. If alerts to a correct number keep failing, contact [support](mailto:support@checklyhq.com). For limits and other SMS-related questions, please refer to our [Pricing page](https://www.checklyhq.com/pricing/#features). From eb544d295bdb83e28ed50c4bce4bd6d7d662262c Mon Sep 17 00:00:00 2001 From: Hannes Lenke Date: Sun, 8 Nov 2026 19:40:48 -0500 Subject: [PATCH 3/6] docs(alerts): two test messages a minute on every plan Tested on an Enterprise account: the third test within a minute returns 429 and the web app shows 'Test rate limit exceeded'; a test after 60 s passes. Co-Authored-By: Claude Opus 5.5 --- integrations/alerts/phone-calls.mdx | 2 +- integrations/alerts/sms.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/integrations/alerts/phone-calls.mdx b/integrations/alerts/phone-calls.mdx index cc8310a21..43297ea9c 100644 --- a/integrations/alerts/phone-calls.mdx +++ b/integrations/alerts/phone-calls.mdx @@ -91,7 +91,7 @@ Each phone call alert that Checkly sends to a channel counts against your accoun When your account has used its quota, or your plan includes no phone calls, Checkly doesn't send the call. The alert appears in the [alert notification log](/communicate/alerts/notification-log) with the delivery status **Failed** and the notification result `Account hit the monthly CALL limit`. -Accounts on a trial can send only a few test calls a day. The limit resets after 24 hours. When you reach that limit, the **Test alert channel** button shows how many seconds to wait. +Accounts on a trial can send only a few test calls a day. The limit resets after 24 hours. When you reach that limit, the **Test alert channel** button shows how many seconds to wait. On every plan, you can send at most two tests a minute, counted across all alert channel types. A third test within the minute fails with **Test rate limit exceeded**. Need more SMS or phone calls? Contact [support](mailto:support@checklyhq.com). diff --git a/integrations/alerts/sms.mdx b/integrations/alerts/sms.mdx index a8739ac8f..164cacdd2 100644 --- a/integrations/alerts/sms.mdx +++ b/integrations/alerts/sms.mdx @@ -100,7 +100,7 @@ Need more SMS or phone calls? Contact [support](mailto:support@checklyhq.com). ## Test messages -Click **Test alert channel** in the channel form to send a test SMS to the number before you save the channel. Accounts on a trial or the Hobby plan can send only a few test messages a day. The limit resets after 24 hours. When you reach that limit, the button shows how many seconds to wait, and the API responds with `429 Too Many Requests` and `Alert channel test rate limit exceeded`. +Click **Test alert channel** in the channel form to send a test SMS to the number before you save the channel. Accounts on a trial or the Hobby plan can send only a few test messages a day. The limit resets after 24 hours. When you reach that limit, the button shows how many seconds to wait, and the API responds with `429 Too Many Requests` and `Alert channel test rate limit exceeded`. On every plan, you can send at most two tests a minute, counted across all alert channel types. A third test within the minute fails with **Test rate limit exceeded**. ## Troubleshooting a missing SMS alert From 6777a0994d4ca460973886184f93337e912b71f4 Mon Sep 17 00:00:00 2001 From: Hannes Lenke Date: Tue, 10 Nov 2026 20:59:21 -0500 Subject: [PATCH 4/6] Apply suggestion from @hlenke --- integrations/alerts/phone-calls.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/integrations/alerts/phone-calls.mdx b/integrations/alerts/phone-calls.mdx index 43297ea9c..649c528b0 100644 --- a/integrations/alerts/phone-calls.mdx +++ b/integrations/alerts/phone-calls.mdx @@ -17,7 +17,7 @@ The phone numbers used for phone call alerting need to be in [E.164 format](http ![send monitoring alerts with phone calls](/images/docs/images/alerting/phone-call.png) -You can add as many phone number channels as you like. Phone call alerts are included on the Team plan and above. On the Hobby plan, you can't create phone call channels. On the Starter plan, you can create and test a phone call channel, but its alerts aren't sent, see [Monthly phone call quota](#monthly-phone-call-quota). +You can add as many phone number channels as you like. Phone call alerts are included on the Team plan and above. On the Hobby plan, you can't create phone call channels. On the Starter plan, you can create and test a phone call channel, but Starter includes no phone calls, so its alerts aren't sent. See [Monthly phone call quota](#monthly-phone-call-quota). Some countries are only available on paid plans, not during a trial: the same countries as for SMS alerts. Numbers are checked the same way as for SMS alerts, see [SMS supported countries and regions](/integrations/alerts/sms#supported-countries-and-regions) for the messages. For a phone call channel, the web app shows `Calls to this country require a paid plan. Upgrade your plan to use this number.` for a paid-only country. From 1367ad91b629226ef83fdd882a6310645d65a3c0 Mon Sep 17 00:00:00 2001 From: Hannes Lenke Date: Tue, 10 Nov 2026 20:59:42 -0500 Subject: [PATCH 5/6] Apply suggestion from @hlenke --- integrations/alerts/phone-calls.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/integrations/alerts/phone-calls.mdx b/integrations/alerts/phone-calls.mdx index 649c528b0..56852e452 100644 --- a/integrations/alerts/phone-calls.mdx +++ b/integrations/alerts/phone-calls.mdx @@ -19,7 +19,7 @@ The phone numbers used for phone call alerting need to be in [E.164 format](http You can add as many phone number channels as you like. Phone call alerts are included on the Team plan and above. On the Hobby plan, you can't create phone call channels. On the Starter plan, you can create and test a phone call channel, but Starter includes no phone calls, so its alerts aren't sent. See [Monthly phone call quota](#monthly-phone-call-quota). -Some countries are only available on paid plans, not during a trial: the same countries as for SMS alerts. Numbers are checked the same way as for SMS alerts, see [SMS supported countries and regions](/integrations/alerts/sms#supported-countries-and-regions) for the messages. For a phone call channel, the web app shows `Calls to this country require a paid plan. Upgrade your plan to use this number.` for a paid-only country. +Some countries are only available on paid plans, not during a trial. They're the same countries as for SMS alerts, and numbers are checked the same way: see [SMS supported countries and regions](/integrations/alerts/sms#supported-countries-and-regions) for the list and the error messages. For a paid-only country, the phone call form shows `Calls to this country require a paid plan. Upgrade your plan to use this number.` ## Supported countries and regions From 1da2531e26d795fe951adbcbd8090942f372b862 Mon Sep 17 00:00:00 2001 From: Hannes Lenke Date: Tue, 10 Nov 2026 21:02:34 -0500 Subject: [PATCH 6/6] docs(sms): list the rejection messages after the country table Co-Authored-By: Claude Opus 5.5 --- integrations/alerts/sms.mdx | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/integrations/alerts/sms.mdx b/integrations/alerts/sms.mdx index 164cacdd2..5994113ee 100644 --- a/integrations/alerts/sms.mdx +++ b/integrations/alerts/sms.mdx @@ -23,15 +23,6 @@ You can add as many SMS channels as you like. SMS channels aren't available on t SMS alerts can only be sent to phone numbers in the following countries. Numbers from other countries are rejected when you create or update the channel. -When a number is rejected, the channel form or the API tells you why: - -| Message | What to do | -| ------ | ------ | -| `The number field must be a valid phone number` (web app) or `phoneNumber is not a valid phone number` (API) | Enter the number in E.164 format: a `+`, the country code and the number, without spaces or dashes. | -| `Invalid country code. Please see our documentation for a full list of supported countries` | Start the number with `+` and the country code, and use a country from the table below. | -| `SMS to this country requires a paid plan. Upgrade your plan to use this number.` (web app) or `SMS and phone call alerts to this country are only available on a paid plan. Upgrade your plan to use this number.` (API) | The country is available on paid plans only, not on trials. | -| `Adding or changing SMS and phone call alert channels requires the Starter plan or above.` (API) | Your account is on the Hobby plan, which doesn't include SMS alerts. | - | Country | Availability | | ------ | ------ | | Argentina (+54) | Paid plans only, not on trials | @@ -86,6 +77,15 @@ When a number is rejected, the channel form or the API tells you why: | Uruguay (+598) | Paid plans only, not on trials | | Vietnam (+84) | Paid plans only, not on trials | +When a number is rejected, the channel form or the API tells you why: + +| Message | What to do | +| ------ | ------ | +| `The number field must be a valid phone number` (web app) or `phoneNumber is not a valid phone number` (API) | Enter the number in E.164 format: a `+`, the country code and the number, without spaces or dashes. | +| `Invalid country code. Please see our documentation for a full list of supported countries` | Start the number with `+` and the country code, and use a country from the table above. | +| `SMS to this country requires a paid plan. Upgrade your plan to use this number.` (web app) or `SMS and phone call alerts to this country are only available on a paid plan. Upgrade your plan to use this number.` (API) | The country is available on paid plans only, not on trials. | +| `Adding or changing SMS and phone call alert channels requires the Starter plan or above.` (API) | Your account is on the Hobby plan, which doesn't include SMS alerts. | + ## SMS alert number and sender ID SMS alerts will be sent with a sender ID and phone number. The Checkly sender ID is 'Checkly'. If your carrier does not support sender ID, you will instead see the Checkly SMS alert phone number, +1(814) 250 8623.