Notice: Twilio Verify V2 SMS Changes (November 2021)

Twilio will be implementing changes to Verify V2 SMS on November 1, 2021. On this date, custom message body content for one-time passcode (OTP) SMS messages will be deprecated, in favor of message templates. To maintain service continuity, we recommend all users review the available templates, and reach out to our Support team with their desired option(s) as soon as possible.

This guide covers the following topics:

Why is Twilio changing Verify V2 SMS?

Twilio is making these changes to conform to global wireless carrier and SMS provider regulations around application-to-person (A2P) SMS messages. By using templates for message body content for OTP SMS messages, our goal is to reduce carrier filtering, and help ensure high message deliverability.

What are the new template options?

Here are the message template options:

Base Templates
{Code} is your verification code for {Service Name}.
Your {Service Name} verification code is: {Code}.
{Code} is your authentication code for {Service Name}.
{Service Name} verification code for password change: {Code}.
{Service Name} verification code for forgotten login ID is: {Code}.
Addenda Templates (Optional secondary messages)
Do not share this code with anyone.
Our employees will never ask for the code.
This code will expire in 10 minutes.

Going forward, Verify V2 SMS users can select 1 Base template message (from the 5 available options), and have the option to add Addenda template(s) (from the 3 available options) if desired.

An example message body using the first Base template and first Addenda template would look like this:

{Code} is your verification code for {Service Name}. Do not share this code with anyone.

How many message bodies am I allowed to use?

Each Verify V2 service can select a single template (1 Base template and optional Addenda templates). Users with multiple Verify V2 services can specify a template for each service.

How do I request the desired template?

To set your desired templates, please contact our Support team with the following information:

  • Your Account SID
  • Your Verify V2 Service SID & Friendly name
  • Your desired template(s) and message body

Notice: Please allow up to 5 days to make this change.

What if I don't select a template?

Starting on November 1, 2021, Twilio Verify will automatically map all new OTP SMS Message requests to one of the new templates. If your template selection(s) are not on file by then, Twilio will attempt to map your message to the template with the best fit.

After February 1, 2022, Twilio will stop automatically mapping these messages. Beginning on this date, any OTP SMS messages that don't conform to the templates will not be sent.

Have more questions? Submit a request
Powered by Zendesk