Skip to content

Improve discoverability for geo-restriction error messages #443

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
hey-august merged 1 commit into from
Jul 2, 2026
+10 −1
Merged

Improve discoverability for geo-restriction error messages #443

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion fern/products/apis/pages/core/error-codes.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -803,7 +803,7 @@ The `code` field above maps to one of the values below. Each entry describes the

<ParamField path="not_routable" type="Error" toc={true}>

- 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.
</ParamField>

<ParamField path="not_routeable" type="Error" toc={true}>
Expand Down
9 changes: 9 additions & 0 deletions ...atform/pages/platform/core/how-to-enable-international-outbound-dialing-sms.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.

</Warning>

## 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.
Loading