Search + K

Command Palette

Search for a command to run...

Sign In

POST /2010-04-01/Accounts/{AccountSid}/IncomingPhoneNumbers/Local.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
{
PhoneNumber: string;
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;
IdentitySid?: `RI${string}`;
AddressSid?: `AD${string}`;
EmergencyStatus?: IncomingPhoneNumberLocalEnumEmergencyStatus

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 IncomingPhoneNumberLocalEnumEmergencyStatus = "Active" | "Inactive"
;
EmergencyAddressSid?: `AD${string}`;
TrunkSid?: `TK${string}`;
VoiceReceiveMode?: IncomingPhoneNumberLocalEnumVoiceReceiveMode
type IncomingPhoneNumberLocalEnumVoiceReceiveMode = "voice" | "fax"
;
BundleSid?: `BU${string}`;
}

Responses

201 application/json

Created

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

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

type IncomingPhoneNumberLocalEnumAddressRequirement = "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?: IncomingPhoneNumberLocalEnumVoiceReceiveMode
type IncomingPhoneNumberLocalEnumVoiceReceiveMode = "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?: IncomingPhoneNumberLocalEnumEmergencyStatus

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 IncomingPhoneNumberLocalEnumEmergencyStatus = "Active" | "Inactive"
;
emergency_address_sid?: `AD${string}` | null;
emergency_address_status?: IncomingPhoneNumberLocalEnumEmergencyAddressStatus

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

type IncomingPhoneNumberLocalEnumEmergencyAddressStatus = "registered" | "unregistered" | "pending-registration" | "registration-failure" | "pending-unregistration" | "unregistration-failure"
;
bundle_sid?: `BU${string}` | null;
status?: string | null;
}