Check a verification code

Check a verification code

Checks the code a user entered against their pending verification and returns its status, approved when the code is right.

Note: Pass the same --to the code was sent to. A verification expires after 10 minutes and is deleted once approved or out of attempts; checking it after that returns 404.

Set up

Use the first option your agent supports.

CLI (official)

Install the command, then confirm it runs.

brew tap twilio/brew && brew install twilio
twilio --version

Run twilio api:verify:v2:services:verification-check:create.

Set $TWILIO_API_KEY in your environment first (get a key: https://www.twilio.com/docs/iam/api-keys/keys-in-console).

Note: Also set TWILIO_ACCOUNT_SID and TWILIO_API_SECRET, with TWILIO_API_KEY holding the API key SID, or sign in once with twilio login.

Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

Rules

• Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
• Never print API keys.