Rate this page:

Migrating from 1.x to 2.x

Version 2 of the Verify API has an improved developer experience and new features. Version 1 of the API will be maintained for the time being, but any new development will be on Version 2.

Some of the exciting features of the V2 API include:

...and more!

This guide provides an introduction to the 2.x Verify API and a set of guidelines to migrate an application from 1.x to 2.x.

2.x Base API

Verify 2.x is now hosted on Twilio's API. The new base URL is:

Credentials / Authentication

V1 required an Authy API Key. The Verify V2 API uses your Twilio Credentials found in the Console like in the following request:

curl -XPOST \
    -d FriendlyName=MyServiceName \

Helper Libraries

Twilio helper libraries now support Verify. You no longer need the separate Authy helper libraries. We officially support libraries for:

Check out our API Reference for examples and more information.

Applications are now Services

2.x relies on Services for configuration. In V1 you created an Authy or Verify Application and used that API Key to manage verifications. In V2 you need both your Twilio Credentials and a Service ID. You can create and update a Service in two ways:

  1. With the Verify API
  2. In the Verify Console

E.164 Phone Number Formatting for SMS and Voice

V1 used country code and phone number as two separate parameters. In V2, phone numbers are processed as one parameter in E.164 format like this: +15552317654.

PSD2 Support

Verify V2 supports PSD2 compliant transaction specific verifications with optional payee and amount fields. See the API reference documentation for details.

Improved Visibility and Insights

Only available with our new Verify API, view the status of your verifications in the console:

verification logs

Python Example

For an example of upgrading from 1.x to 2.x, take a look at this lightweight Python/Flask Example.

Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Community Forums or browsing the Twilio tag on Stack Overflow.


        Thank you for your feedback!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more