Sample - Twilio API
POST/2010-04-01/Accounts/{AccountSid}/OutgoingCallerIds.json

Create an outgoing caller ID validation request

Creates a validation request for a phone number that will become an outgoing caller ID. Supply PhoneNumber and optionally configure the caller ID name, verification call timing, extension, and callback handling.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter · 6 body fields
AccountSidstringrequired
The account SID responsible for the new caller ID resource. Must be a 34-character SID matching the `AC` prefix format.

Form-encoded details for initiating phone number verification.

PhoneNumberstringrequired
The phone number to verify in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number.
FriendlyNamestringoptional
A descriptive string that you create to describe the new caller ID resource. It can be up to 64 characters long. The default value is a formatted version of the phone number.
CallDelayintegeroptional
The number of seconds to delay before initiating the verification call. Can be an integer between `0` and `60`, inclusive. The default is `0`.
Extensionstringoptional
The digits to dial after connecting the verification call.
StatusCallbackstringoptional
The URL we should call using the `status_callback_method` to send status information about the verification process to your application.
StatusCallbackMethodstringoptional
The HTTP method we should use to call `status_callback`. Can be: `GET` or `POST`, and the default is `POST`.
Allowed:GETPOST

1 status code
200Returns the validation request details, including the account SID, verification call SID, friendly name, phone number, and six-digit validation code.
account_sidstringoptional
The SID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for the Caller ID.
call_sidstringoptional
The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Caller ID is associated with.
friendly_namestringoptional
The string that you assigned to describe the resource.
phone_numberstringoptional
The phone number to verify in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number.
validation_codestringoptional
The 6 digit validation code that someone must enter to validate the Caller ID when `phone_number` is called.

Error handling

PhoneNumber is required and must use phone-number format. CallDelay must be between 0 and 60 seconds, StatusCallbackMethod must be GET or POST, and StatusCallback must be a URI when supplied.