Purchase a phone-number for the account.

POST /2010-04-01/Accounts/{AccountSid}/IncomingPhoneNumbers.json

Copy endpoint

https://api.twilio.com

Parameters

path Path Parameters

Name	Type
`AccountSid` required The SID of the Account that will create the resource.	`AC${string}`

Request Body

application/x-www-form-urlencoded

{
ApiVersion?: string;
FriendlyName?: string;
SmsApplicationSid?: `AP${string}`;
SmsFallbackMethod?: "GET" | "POST";
SmsFallbackUrl?: string;
SmsMethod?: "GET" | "POST";
SmsUrl?: string;
StatusCallback?: string;
StatusCallbackMethod?: "GET" | "POST";
VoiceApplicationSid?: `AP${string}`;
VoiceCallerIdLookup?: boolean;
VoiceFallbackMethod?: "GET" | "POST";
VoiceFallbackUrl?: string;
VoiceMethod?: "GET" | "POST";
VoiceUrl?: string;
EmergencyStatus?:

IncomingPhoneNumberEnumEmergencyStatus

The parameter displays if emergency calling is enabled for this number. Active numbers may place emergency calls by dialing valid emergency numbers for the country.

type IncomingPhoneNumberEnumEmergencyStatus = "Active" | "Inactive"

;
EmergencyAddressSid?: `AD${string}`;
TrunkSid?: `TK${string}`;
IdentitySid?: `RI${string}`;
AddressSid?: `AD${string}`;
VoiceReceiveMode?:

IncomingPhoneNumberEnumVoiceReceiveMode

type IncomingPhoneNumberEnumVoiceReceiveMode = "voice" | "fax"

;
BundleSid?: `BU${string}`;
PhoneNumber?: string;
AreaCode?: string;
}

Responses

201 application/json

Created

interface ApiV2010AccountIncomingPhoneNumber {
account_sid?: `AC${string}` | null;
address_sid?: `AD${string}` | null;
address_requirements?:

IncomingPhoneNumberEnumAddressRequirement

Whether the phone number requires an Address registered with Twilio. Can be: none, any, local, or foreign.

type IncomingPhoneNumberEnumAddressRequirement = "none" | "any" | "local" | "foreign"

;
api_version?: string | null;
beta?: boolean | null;
capabilities?: {
mms?: boolean;
sms?: boolean;
voice?: boolean;
fax?: boolean;
} | null;
date_created?: string | null;
date_updated?: string | null;
friendly_name?: string | null;
identity_sid?: `RI${string}` | null;
phone_number?: string | null;
origin?: string | null;
sid?: `PN${string}` | null;
sms_application_sid?: `AP${string}` | null;
sms_fallback_method?: "GET" | "POST" | null;
sms_fallback_url?: string | null;
sms_method?: "GET" | "POST" | null;
sms_url?: string | null;
status_callback?: string | null;
status_callback_method?: "GET" | "POST" | null;
trunk_sid?: `TK${string}` | null;
uri?: string | null;
voice_receive_mode?:

IncomingPhoneNumberEnumVoiceReceiveMode

type IncomingPhoneNumberEnumVoiceReceiveMode = "voice" | "fax"

;
voice_application_sid?: `AP${string}` | null;
voice_caller_id_lookup?: boolean | null;
voice_fallback_method?: "GET" | "POST" | null;
voice_fallback_url?: string | null;
voice_method?: "GET" | "POST" | null;
voice_url?: string | null;
emergency_status?:

IncomingPhoneNumberEnumEmergencyStatus

The parameter displays if emergency calling is enabled for this number. Active numbers may place emergency calls by dialing valid emergency numbers for the country.

type IncomingPhoneNumberEnumEmergencyStatus = "Active" | "Inactive"

;
emergency_address_sid?: `AD${string}` | null;
emergency_address_status?:

IncomingPhoneNumberEnumEmergencyAddressStatus

The status of address registration with emergency services. A registered emergency address will be used during handling of emergency calls from this number.

;
bundle_sid?: `BU${string}` | null;
status?: string | null;
}