From 723d47e99033eb39e7bc4aefc3ca42e5ff3f73a0 Mon Sep 17 00:00:00 2001 From: August L-R Date: Thu, 2 Jul 2026 17:00:04 +0000 Subject: [PATCH] Improve discoverability for geo-restriction error messages --- fern/products/apis/pages/core/error-codes.mdx | 2 +- .../how-to-enable-international-outbound-dialing-sms.mdx | 9 +++++++++ 2 files changed, 10 insertions(+), 1 deletion(-) diff --git a/fern/products/apis/pages/core/error-codes.mdx b/fern/products/apis/pages/core/error-codes.mdx index 6ac8c696f7..e63e33d624 100644 --- a/fern/products/apis/pages/core/error-codes.mdx +++ b/fern/products/apis/pages/core/error-codes.mdx @@ -803,7 +803,7 @@ The `code` field above maps to one of the values below. Each entry describes the -- Unable to locate a route to the destination number. Please check geographic permissions and the destination number, and contact Support if issues persist. +- Unable to locate a route to the destination number. Please check [geographic permissions](/docs/platform/how-to-enable-international-services) and the destination number, and contact Support if issues persist. diff --git a/fern/products/platform/pages/platform/core/how-to-enable-international-outbound-dialing-sms.mdx b/fern/products/platform/pages/platform/core/how-to-enable-international-outbound-dialing-sms.mdx index d242e2c9d8..ecb8e7218b 100644 --- a/fern/products/platform/pages/platform/core/how-to-enable-international-outbound-dialing-sms.mdx +++ b/fern/products/platform/pages/platform/core/how-to-enable-international-outbound-dialing-sms.mdx @@ -83,3 +83,12 @@ Please Note: Messaging can only be sent from US and Canadian (CA) long code numb International SMS is not enabled for toll-free numbers. + +## Troubleshooting + +If you attempt to call or message a destination in a country you have not enabled, the request +fails because no route to that destination is permitted by your account. REST requests return the +[`not_routable`](/docs/apis/error-codes#not_routable) error code. + +To resolve it, confirm International Services are active on your Space and that the destination +country is checked under **Geographic Permissions**, following the steps above.