As part of Twilio's account security offerings, the Twilio Verify API makes it simple to add phone verification to your web application. It supports codes sent via voice and SMS.
All URLs referenced in the documentation have the following base:
The Twilio REST API is served over HTTPS. To ensure data privacy, unencrypted HTTP is not supported.
HTTP requests to the REST API are protected with HTTP Basic authentication. To learn more about how Twilio handles authentication, please refer to our security documentation. In short, you will use your Twilio account SID as the username and your auth token as the password for HTTP Basic authentication.
curl -XPOST https://verify.twilio.com/v2/Services \ -d FriendlyName=MyServiceName \ -u '[YOUR ACCOUNT SID]:[YOUR AUTH TOKEN]'
You can find your account SID and auth token in your console.
This guide shows the 3 steps to completing a basic phone verification. Follow the links for more documentation on advanced features such as service configuration, custom codes, rate limiting, PSD2 compliance, and more.
Create a Service in one of two ways:
A Verification Service is the set of common configurations used to create and check verifications. This includes features like:
- Friendly Name (used in the Verification message templates)
- Code Length
- ...and more
One verification service can be used to send multiple verification tokens, it is not necessary to create a new service each time.
This will send a token to the end user through the specified channel. Newly created verifications will show a status of
pending. Supported channels are
This will check whether the user-provided token is correct.
|Token||Status in response|
We're always looking to improve our Verify API and its documentation. If you have any thoughts, comments, questions, or feedback, rate this page and leave us a note. We really do read these!