As of November 2022, Twilio no longer provides support for Authy SMS/Voice-only customers. Customers who were also using Authy TOTP or Push prior to March 1, 2023 are still supported. The Authy API is now closed to new customers and will be fully deprecated in the future.
For new development, we encourage you to use the Verify v2 API.
Existing customers will not be impacted at this time until Authy API has reached End of Life. For more information about migration, see Migrating from Authy to Verify for SMS.
A verification message's locale will automatically resolve based on the country code of the phone number provided and use English as a fallback language. Using automatic resolution is highly recommended. See a list of phone number country code to language mappings here. If a language override is still required, you can use the locale parameter.
We support the format country-region as described in IETF's BPC 47 for the languages listed below. If an unsupported override locale is given, a 404 error will be returned. In that case, we recommend that you retry the request without the locale parameter to implement a fallback to the country code's default language or English.
Supported languages include:
| Name | Language Tag |
|---|---|
| Afrikaans | af |
| Arabic | ar |
| Catalan | ca |
| Chinese (Simplified using mainland terms) | zh |
| Chinese (Simplified using mainland terms) | zh-CN |
| Chinese (Simplified using Hong Kong terms) | zh-HK |
| Croatian | hr |
| Czech | cs |
| Danish | da |
| Dutch | nl |
| English (American) | en |
| English (British) | en-GB |
| Estonian | et |
| Finnish | fi |
| French | fr |
| German | de |
| Greek | el |
| Hebrew | he |
| Hindi | hi |
| Hungarian | hu |
| Indonesian | id |
| Italian | it |
| Japanese | ja |
| Kannada | kn |
| Korean | ko |
| Lithuanian | lt |
| Malay | ms |
| Marathi | mr |
| Norwegian | nb |
| Polish | pl |
| Portuguese - Brazil | pt-BR |
| Portuguese | pt |
| Romanian | ro |
| Russian | ru |
| Slovak | sk |
| Spanish | es |
| Swedish | sv |
| Tagalog | tl |
| Telugu | te |
| Thai | th |
| Turkish | tr |
| Ukrainian (SMS only) | uk |
| Vietnamese | vi |
SMS messages sent with Programmable Messaging, Verify, and Authy are priced per message segment.
Messages sent in certain language locales, including pt, pt_BR, cs, and el or in non-GSM characters may be split into multiple message segments. You can check how many message segments your message will use with the Messaging Segment Calculator tool.
Learn more about how to limit message segments in our developer best practices.
Here's a basic select implementation in JavaScript: