Background
Standard Behavior
Verification call is initiated.
Telnyx calls the target phone number.
Call is answered.
Verification code is played.
User enters the code to complete verification.
New Behavior (with IVR Extensions)
Verification call is initiated, including IVR navigation digits.
Telnyx calls the target phone number.
Call is answered by the IVR.
Telnyx waits, then dials the extension.
Extension answers the call.
Verification code is played.
User enters the code to complete verification.
Pre-requisites
Before you begin, make sure you have:
A Telnyx Mission Control Portal account.
A valid Telnyx API key (you can generate one in the Mission Control Portal).
The phone number you want to verify, in E.164 format (e.g., +15741156782).
Step 1: Prepare Your API Key
You’ll need to include your Telnyx API key in the Authorization header of your request:
Authorization: Bearer KEYXXXXXXXXXXXXXX
Step 2: Understand the Parameters
phone_number: Destination number in E.164 format.
verification_method: The method of verification. (Currently
callis supported.)extension: The DTMF sequence to navigate the IVR.
w= wait 0.5 secondsW= wait 1 secondDigits
0–9and lettersA–DExample:
www2wW4w53ww3
Step 3: Make the API Request
Use the Create Verified Number endpoint.
Curl example:
curl --location --request POST 'https://api.telnyx.com/v2/verified_numbers' \ --header 'phone_number: +15741156782' \ --header 'verification_method: call' \ --header 'extension: www2wW4w53ww3' \ --header 'Authorization: Bearer KEYXXXXXXXXXXXXXX'
Replace KEYXXXXXXXXXXXXXX with your actual API key.
Step 4: Check the Response
If successful, you’ll receive a JSON response:
{ "phone_number": "+15741156782", "verification_method": "call", "extension": "www2wW4w53ww3" }If the request fails (e.g., number not in E.164 format), you’ll see an error object describing the issue.
Through the Mission Control Portal
Login to the Mission Control Portal and navigate to the Numbers>Manage Numbers Page from the left side menu. You can also use this direct link after login.
Switch to the Verified Numbers Tab.
Add details of your number and the extension following the format from step 2 above. Select "Call me with a code". You will receive a call, from which the verification code will be read for input to complete verification.
Tips for Success
Always format phone numbers in E.164 (e.g., +1 for US numbers).
Test your extension sequence manually with the IVR before automating.
Use
wto add short waits when the IVR is slow to respond.Keep your API key private—never share it publicly.