Twilio error 21408 means your account has not been granted permission to send messages or make calls to the destination country or region. Geographic permissions are a security control that requires explicit opt-in for each country you intend to reach, preventing unauthorized international charges if your account credentials are ever compromised. This error is thrown at the API validation stage before any carrier routing occurs and is resolved entirely through the Console settings.
What Causes This Error
The direct cause is a geographic permission for the destination country that is either disabled or was never enabled on your account. All new Twilio accounts have only a limited set of countries enabled by default, typically including the US, Canada, and the UK, and all other countries must be manually enabled before you can send to them. A common scenario is a developer sending to the US during development without issue, then discovering 21408 when they attempt to send to a new international market for the first time. Subaccounts also inherit a separate geographic permission configuration from their parent account, and a country enabled on the parent account may not automatically be enabled on a subaccount, causing 21408 when the subaccount makes the API call.
How to Fix It Step by Step
Log into the Twilio Console and navigate to Settings, then Geo Permissions (for voice calls) or Messaging, then Settings, then Geo Permissions (for SMS). Find the country code of the destination you are trying to reach in the list: countries are organized alphabetically and each has a toggle that shows its current enabled or disabled state. Toggle the country to enabled and save the change, which takes effect immediately for new API requests without any propagation delay. After enabling the permission, retry your original API call to confirm the 21408 error no longer appears and the message or call proceeds to the carrier routing stage.
How to Prevent It from Recurring
As part of your pre-launch checklist for any new messaging campaign or application feature that introduces a new destination country, include a step that verifies the geographic permission for that country is enabled before the feature goes live. Automate geo permission verification by writing a startup script that calls the Twilio Geo Permissions API, retrieves the list of enabled countries, and compares it against your application's configured destination country list, alerting your team if any destination country is not enabled. For accounts with multiple subaccounts, audit each subaccount's geographic permissions separately, since the Console's parent account view does not show subaccount permission states, and missing permissions on a subaccount can cause 21408 in production applications that use subaccount credentials. Maintain a documented list of all countries your business sends to and review the geographic permissions settings quarterly to ensure no country has been accidentally disabled.
When to Call a Specialist
Some countries require additional verification before Twilio will enable geographic permissions, such as completing a Know Your Customer form or agreeing to country-specific terms of service, and the Console's geo permission toggle may not activate successfully until this verification is complete. A specialist can identify which verification steps are required for specific high-restriction countries and guide you through completing them efficiently. If you have enabled a country's geographic permission but are still receiving 21408 for numbers in that country, the issue may be with a specific region, operator, or number type within that country that has separate restrictions, which requires Twilio support investigation. For businesses expanding to multiple new international markets simultaneously, a specialist can perform an upfront audit of permission requirements and complete the necessary verification steps for all target markets in a coordinated manner.
Conclusion
Error 21408 is a geographic permission gate that is opened in sixty seconds through the Console settings once you know which country to enable. If this error is blocking your production system, contact our team and we will diagnose and fix it within the hour.
Ready to Transform Your Business Communications?
Get a free consultation with our VoIP experts and discover how we can help you save costs, improve efficiency, and scale your business.
Comments (0)
Join the discussion and share your thoughts (AI-moderated for quality)
Be the first to comment
No comments yet. Share your thoughts below.