Rate this page:

Verify Push SDK Technical Overview

Verify Push is in Public Beta.

Data model

The data model does not require any PII (such as phone or email).

Verify Push Data Model

Resource definitions

  • Service: an organization or environment (e.g. stage, prod). Contains configurations for all verification methods available through the Verify platform (SMS OTP, Voice OTP, Email OTP, Push Verification). A Twilio [sub]account can have multiple Services. Each Service contains multiple Entities that are not shared across Services.
  • Entity: a user or other identity that needs verification. An Entity can contain multiple Factors.
  • Factor: a verification method, which involves an exchange of secrets via a communication channel. For factor_type push, which is based on public-key cryptography, the Factor contains the public key of the private-public keypair generated by a registered device along with its metadata. A Factor contains multiple Challenges.
  • Challenge: a single verification attempt of an Entity using a Factor. A single Factor has multiple Challenges.
  • Access Token: an authentication token that a client app (e.g. Android app) uses to authenticate its request to the Verify Push API when creating (i.e., enrolling or registering) an Entity and/or Factor.
  • Webhook: a config that specifies that Verify Push notifies your app backend of an event.

Sample App Demo


Watch this demo to see how the data model is used to register a user/device and verify a user. The demo uses a Sample App and Sample Backend. These samples are like transparent versions of a real mobile app and app backend integrated with Verify Push, but they fully expose the API calls that are being made and the data exchange behind the scenes. 

Sequence Diagram

Verify Push SDK involves two main sequences:

  1. Register user and device
  2. Verify a user

Verify Push SDK Sequence Diagram

Ready to start building?

Check out these quickstarts for step-by-step instructions:

Check out another demo of Verify Push being used for login authentication:

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 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