# IncomingPhoneNumber resource An **IncomingPhoneNumber** instance resource represents a phone number that you provision, port, or host with Twilio. The IncomingPhoneNumbers list resource represents an account's Twilio phone numbers. You can `POST` to the list resource to [provision a new Twilio number](/docs/phone-numbers/api/incomingphonenumber-resource). To find a number to provision, use the subresources of the [AvailablePhoneNumbers](/docs/phone-numbers/api/availablephonenumber-resource) resource. You can transfer phone numbers between two Twilio accounts if you're using [subaccounts](/docs/iam/api/subaccounts). For details, see [Exchanging Numbers Between Subaccounts](/docs/iam/api/subaccounts#exchanging-numbers). > \[!NOTE] > > Provisioning a phone number is a two-step process: > > 1. Find an available phone number to provision by making a [`GET` request to the subresources of the AvailablePhoneNumbers resource](/docs/phone-numbers/api/availablephonenumber-resource). > 2. Make a [`POST` request to the IncomingPhoneNumbers resource](#create-an-incomingphonenumber-resource). > \[!WARNING] > > The order of columns in the CSV can change as we add fields to the API response. Design your application to handle column-order changes. The following properties are available for the IncomingPhoneNumber resource: ## IncomingPhoneNumber Properties ```json {"type":"object","refName":"api.v2010.account.incoming_phone_number","modelName":"api_v2010_account_incoming_phone_number","properties":{"account_sid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AC[0-9a-fA-F]{32}$","nullable":true,"description":"The SID of the [Account](/docs/iam/api/account) that created this IncomingPhoneNumber resource."},"address_sid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AD[0-9a-fA-F]{32}$","nullable":true,"description":"The SID of the Address resource associated with the phone number."},"address_requirements":{"type":"string","enum":["none","any","local","foreign"],"description":"Whether the phone number requires an [Address](/docs/usage/api/address) registered with Twilio. Can be: `none`, `any`, `local`, or `foreign`.","refName":"incoming_phone_number_enum_address_requirement","modelName":"incoming_phone_number_enum_address_requirement"},"api_version":{"type":"string","nullable":true,"description":"The API version used to start a new TwiML session."},"beta":{"type":"boolean","nullable":true,"description":"Whether the phone number is new to the Twilio platform. Can be: `true` or `false`."},"capabilities":{"type":"object","format":"phone-number-capabilities","x-class-extra-annotation":"@JsonInclude(JsonInclude.Include.NON_NULL)","nullable":true,"description":"The set of Boolean properties that indicate whether a phone number can receive calls or messages. Capabilities are `Voice`, `SMS`, and `MMS` and each capability can be: `true` or `false`.","properties":{"mms":{"type":"boolean","x-field-extra-annotation":"@JacksonXmlProperty(localName=\"MMS\")","x-getter-extra-annotation":"@JacksonXmlProperty(localName=\"MMS\")"},"sms":{"type":"boolean","x-field-extra-annotation":"@JacksonXmlProperty(localName=\"SMS\")","x-getter-extra-annotation":"@JacksonXmlProperty(localName=\"SMS\")"},"voice":{"type":"boolean"},"fax":{"type":"boolean"}}},"date_created":{"type":"string","format":"date-time-rfc-2822","nullable":true,"description":"The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format."},"date_updated":{"type":"string","format":"date-time-rfc-2822","nullable":true,"description":"The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format."},"friendly_name":{"type":"string","nullable":true,"description":"The string that you assigned to describe the resource.","x-twilio":{"pii":{"handling":"standard","deleteSla":30}}},"identity_sid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^RI[0-9a-fA-F]{32}$","nullable":true,"description":"The SID of the Identity resource that we associate with the phone number. Some regions require an Identity to meet local regulations."},"phone_number":{"type":"string","format":"phone-number","nullable":true,"description":"The phone number in [E.164](/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number."},"origin":{"type":"string","nullable":true,"description":"The phone number's origin. `twilio` identifies Twilio-owned phone numbers and `hosted` identifies hosted phone numbers."},"sid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^PN[0-9a-fA-F]{32}$","nullable":true,"description":"The unique string that that we created to identify this IncomingPhoneNumber resource."},"sms_application_sid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AP[0-9a-fA-F]{32}$","nullable":true,"description":"The SID of the application that handles SMS messages sent to the phone number. If an `sms_application_sid` is present, we ignore all `sms_*_url` values and use those of the application."},"sms_fallback_method":{"type":"string","format":"http-method","enum":["GET","POST"],"nullable":true,"description":"The HTTP method we use to call `sms_fallback_url`. Can be: `GET` or `POST`."},"sms_fallback_url":{"type":"string","format":"uri","nullable":true,"description":"The URL that we call when an error occurs while retrieving or executing the TwiML from `sms_url`."},"sms_method":{"type":"string","format":"http-method","enum":["GET","POST"],"nullable":true,"description":"The HTTP method we use to call `sms_url`. Can be: `GET` or `POST`."},"sms_url":{"type":"string","format":"uri","nullable":true,"description":"The URL we call when the phone number receives an incoming SMS message."},"status_callback":{"type":"string","format":"uri","nullable":true,"description":"The URL we call using the `status_callback_method` to send status information to your application."},"status_callback_method":{"type":"string","format":"http-method","enum":["GET","POST"],"nullable":true,"description":"The HTTP method we use to call `status_callback`. Can be: `GET` or `POST`."},"trunk_sid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^TK[0-9a-fA-F]{32}$","nullable":true,"description":"The SID of the Trunk that handles calls to the phone number. If a `trunk_sid` is present, we ignore all of the voice urls and voice applications and use those set on the Trunk. Setting a `trunk_sid` will automatically delete your `voice_application_sid` and vice versa."},"uri":{"type":"string","nullable":true,"description":"The URI of the resource, relative to `https://api.twilio.com`."},"voice_receive_mode":{"type":"string","enum":["voice","fax"],"refName":"incoming_phone_number_enum_voice_receive_mode","modelName":"incoming_phone_number_enum_voice_receive_mode"},"voice_application_sid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AP[0-9a-fA-F]{32}$","nullable":true,"description":"The SID of the application that handles calls to the phone number. If a `voice_application_sid` is present, we ignore all of the voice urls and use those set on the application. Setting a `voice_application_sid` will automatically delete your `trunk_sid` and vice versa."},"voice_caller_id_lookup":{"type":"boolean","nullable":true,"description":"Whether we look up the caller's caller-ID name from the CNAM database ($0.01 per look up). Can be: `true` or `false`."},"voice_fallback_method":{"type":"string","format":"http-method","enum":["GET","POST"],"nullable":true,"description":"The HTTP method we use to call `voice_fallback_url`. Can be: `GET` or `POST`."},"voice_fallback_url":{"type":"string","format":"uri","nullable":true,"description":"The URL that we call when an error occurs retrieving or executing the TwiML requested by `url`."},"voice_method":{"type":"string","format":"http-method","enum":["GET","POST"],"nullable":true,"description":"The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`."},"voice_url":{"type":"string","format":"uri","nullable":true,"description":"The URL we call when the phone number receives a call. The `voice_url` will not be used if a `voice_application_sid` or a `trunk_sid` is set."},"emergency_status":{"type":"string","enum":["Active","Inactive"],"description":"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.","refName":"incoming_phone_number_enum_emergency_status","modelName":"incoming_phone_number_enum_emergency_status"},"emergency_address_sid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AD[0-9a-fA-F]{32}$","nullable":true,"description":"The SID of the emergency address configuration that we use for emergency calling from this phone number."},"emergency_address_status":{"type":"string","enum":["registered","unregistered","pending-registration","registration-failure","pending-unregistration","unregistration-failure"],"description":"The status of address registration with emergency services. A registered emergency address will be used during handling of emergency calls from this number.","refName":"incoming_phone_number_enum_emergency_address_status","modelName":"incoming_phone_number_enum_emergency_address_status"},"bundle_sid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^BU[0-9a-fA-F]{32}$","nullable":true,"description":"The SID of the Bundle resource that you associate with the phone number. Some regions require a Bundle to meet local Regulations."},"status":{"type":"string","nullable":true},"type":{"type":"string","nullable":true,"description":"The phone number type."}}} ``` ## Create an IncomingPhoneNumber resource `POST https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/IncomingPhoneNumbers.json` ### Path parameters ```json [{"name":"AccountSid","in":"path","description":"The SID of the [Account](/docs/iam/api/account) that will create the resource.","schema":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AC[0-9a-fA-F]{32}$"},"required":true}] ``` ### Request body parameters ```json {"schema":{"type":"object","title":"CreateIncomingPhoneNumberRequest","properties":{"ApiVersion":{"type":"string","description":"The API version to use for incoming calls made to the new phone number. The default is `2010-04-01`."},"FriendlyName":{"type":"string","description":"A descriptive string that you created to describe the new phone number. It can be up to 64 characters long. By default, this is a formatted version of the new phone number.","x-twilio":{"pii":{"handling":"standard","deleteSla":30}}},"SmsApplicationSid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AP[0-9a-fA-F]{32}$","description":"The SID of the application that should handle SMS messages sent to the new phone number. If an `sms_application_sid` is present, we ignore all of the `sms_*_url` urls and use those set on the application."},"SmsFallbackMethod":{"type":"string","format":"http-method","enum":["GET","POST"],"description":"The HTTP method that we should use to call `sms_fallback_url`. Can be: `GET` or `POST` and defaults to `POST`."},"SmsFallbackUrl":{"type":"string","format":"uri","description":"The URL that we should call when an error occurs while requesting or executing the TwiML defined by `sms_url`."},"SmsMethod":{"type":"string","format":"http-method","enum":["GET","POST"],"description":"The HTTP method that we should use to call `sms_url`. Can be: `GET` or `POST` and defaults to `POST`."},"SmsUrl":{"type":"string","format":"uri","description":"The URL we should call when the new phone number receives an incoming SMS message."},"StatusCallback":{"type":"string","format":"uri","description":"The URL we should call using the `status_callback_method` to send status information to your application."},"StatusCallbackMethod":{"type":"string","format":"http-method","enum":["GET","POST"],"description":"The HTTP method we should use to call `status_callback`. Can be: `GET` or `POST` and defaults to `POST`."},"VoiceApplicationSid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AP[0-9a-fA-F]{32}$","description":"The SID of the application we should use to handle calls to the new phone number. If a `voice_application_sid` is present, we ignore all of the voice urls and use only those set on the application. Setting a `voice_application_sid` will automatically delete your `trunk_sid` and vice versa."},"VoiceCallerIdLookup":{"type":"boolean","description":"Whether to lookup the caller's name from the CNAM database and post it to your app. Can be: `true` or `false` and defaults to `false`."},"VoiceFallbackMethod":{"type":"string","format":"http-method","enum":["GET","POST"],"description":"The HTTP method that we should use to call `voice_fallback_url`. Can be: `GET` or `POST` and defaults to `POST`."},"VoiceFallbackUrl":{"type":"string","format":"uri","description":"The URL that we should call when an error occurs retrieving or executing the TwiML requested by `url`."},"VoiceMethod":{"type":"string","format":"http-method","enum":["GET","POST"],"description":"The HTTP method that we should use to call `voice_url`. Can be: `GET` or `POST` and defaults to `POST`."},"VoiceUrl":{"type":"string","format":"uri","description":"The URL that we should call to answer a call to the new phone number. The `voice_url` will not be called if a `voice_application_sid` or a `trunk_sid` is set."},"EmergencyStatus":{"type":"string","enum":["Active","Inactive"],"description":"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.","refName":"incoming_phone_number_enum_emergency_status","modelName":"incoming_phone_number_enum_emergency_status"},"EmergencyAddressSid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AD[0-9a-fA-F]{32}$","description":"The SID of the emergency address configuration to use for emergency calling from the new phone number."},"TrunkSid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^TK[0-9a-fA-F]{32}$","description":"The SID of the Trunk we should use to handle calls to the new phone number. If a `trunk_sid` is present, we ignore all of the voice urls and voice applications and use only those set on the Trunk. Setting a `trunk_sid` will automatically delete your `voice_application_sid` and vice versa."},"IdentitySid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^RI[0-9a-fA-F]{32}$","description":"The SID of the Identity resource that we should associate with the new phone number. Some regions require an identity to meet local regulations."},"AddressSid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AD[0-9a-fA-F]{32}$","description":"The SID of the Address resource we should associate with the new phone number. Some regions require addresses to meet local regulations."},"VoiceReceiveMode":{"type":"string","enum":["voice","fax"],"refName":"incoming_phone_number_enum_voice_receive_mode","modelName":"incoming_phone_number_enum_voice_receive_mode"},"BundleSid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^BU[0-9a-fA-F]{32}$","description":"The SID of the Bundle resource that you associate with the phone number. Some regions require a Bundle to meet local Regulations."},"PhoneNumber":{"type":"string","format":"phone-number","description":"The phone number to purchase specified in [E.164](/docs/glossary/what-e164) format. E.164 phone numbers consist of a + followed by the country code and subscriber number without punctuation characters. For example, +14155551234."},"AreaCode":{"type":"string","description":"The desired area code for your new incoming phone number. Can be any three-digit, US or Canada area code. We will provision an available phone number within this area code for you. **You must provide an `area_code` or a `phone_number`.** (US and Canada only)."}}},"examples":{"create":{"value":{"lang":"json","value":"{\n \"AddressSid\": \"ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"ApiVersion\": \"api_version\",\n \"AreaCode\": \"area_code\",\n \"EmergencyStatus\": \"Active\",\n \"EmergencyAddressSid\": \"ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"IdentitySid\": \"RIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"FriendlyName\": \"friendly_name\",\n \"PhoneNumber\": \"+18089255327\",\n \"SmsApplicationSid\": \"APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"SmsFallbackMethod\": \"GET\",\n \"SmsFallbackUrl\": \"https://example.com\",\n \"SmsMethod\": \"GET\",\n \"SmsUrl\": \"https://example.com\",\n \"StatusCallback\": \"https://example.com\",\n \"StatusCallbackMethod\": \"GET\",\n \"VoiceApplicationSid\": \"APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"VoiceCallerIdLookup\": \"true\",\n \"VoiceFallbackMethod\": \"GET\",\n \"VoiceFallbackUrl\": \"https://example.com\",\n \"VoiceMethod\": \"GET\",\n \"VoiceUrl\": \"https://example.com\",\n \"BundleSid\": \"BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"\n}","meta":"","code":"{\n \"AddressSid\": \"ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"ApiVersion\": \"api_version\",\n \"AreaCode\": \"area_code\",\n \"EmergencyStatus\": \"Active\",\n \"EmergencyAddressSid\": \"ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"IdentitySid\": \"RIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"FriendlyName\": \"friendly_name\",\n \"PhoneNumber\": \"+18089255327\",\n \"SmsApplicationSid\": \"APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"SmsFallbackMethod\": \"GET\",\n \"SmsFallbackUrl\": \"https://example.com\",\n \"SmsMethod\": \"GET\",\n \"SmsUrl\": \"https://example.com\",\n \"StatusCallback\": \"https://example.com\",\n \"StatusCallbackMethod\": \"GET\",\n \"VoiceApplicationSid\": \"APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"VoiceCallerIdLookup\": \"true\",\n \"VoiceFallbackMethod\": \"GET\",\n \"VoiceFallbackUrl\": \"https://example.com\",\n \"VoiceMethod\": \"GET\",\n \"VoiceUrl\": \"https://example.com\",\n \"BundleSid\": \"BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"\n}","tokens":[["{","#C9D1D9"],"\n ",["\"AddressSid\"","#7EE787"],[":","#C9D1D9"]," ",["\"ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"ApiVersion\"","#7EE787"],[":","#C9D1D9"]," ",["\"api_version\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"AreaCode\"","#7EE787"],[":","#C9D1D9"]," ",["\"area_code\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"EmergencyStatus\"","#7EE787"],[":","#C9D1D9"]," ",["\"Active\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"EmergencyAddressSid\"","#7EE787"],[":","#C9D1D9"]," ",["\"ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"IdentitySid\"","#7EE787"],[":","#C9D1D9"]," ",["\"RIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"FriendlyName\"","#7EE787"],[":","#C9D1D9"]," ",["\"friendly_name\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"PhoneNumber\"","#7EE787"],[":","#C9D1D9"]," ",["\"+18089255327\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"SmsApplicationSid\"","#7EE787"],[":","#C9D1D9"]," ",["\"APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"SmsFallbackMethod\"","#7EE787"],[":","#C9D1D9"]," ",["\"GET\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"SmsFallbackUrl\"","#7EE787"],[":","#C9D1D9"]," ",["\"https://example.com\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"SmsMethod\"","#7EE787"],[":","#C9D1D9"]," ",["\"GET\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"SmsUrl\"","#7EE787"],[":","#C9D1D9"]," ",["\"https://example.com\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"StatusCallback\"","#7EE787"],[":","#C9D1D9"]," ",["\"https://example.com\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"StatusCallbackMethod\"","#7EE787"],[":","#C9D1D9"]," ",["\"GET\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"VoiceApplicationSid\"","#7EE787"],[":","#C9D1D9"]," ",["\"APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"VoiceCallerIdLookup\"","#7EE787"],[":","#C9D1D9"]," ",["\"true\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"VoiceFallbackMethod\"","#7EE787"],[":","#C9D1D9"]," ",["\"GET\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"VoiceFallbackUrl\"","#7EE787"],[":","#C9D1D9"]," ",["\"https://example.com\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"VoiceMethod\"","#7EE787"],[":","#C9D1D9"]," ",["\"GET\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"VoiceUrl\"","#7EE787"],[":","#C9D1D9"]," ",["\"https://example.com\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BundleSid\"","#7EE787"],[":","#C9D1D9"]," ",["\"BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","#A5D6FF"],"\n",["}","#C9D1D9"]],"annotations":[],"themeName":"github-dark","style":{"color":"#c9d1d9","background":"#0d1117"}}}},"encodingType":"application/x-www-form-urlencoded","conditionalParameterMap":{"PhoneNumber":["AreaCode"],"AreaCode":["PhoneNumber"]}} ``` The following examples demonstrate how to provision phone numbers with various configurations: Provision a Phone Number ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function createIncomingPhoneNumber() { const incomingPhoneNumber = await client.incomingPhoneNumbers.create({ phoneNumber: "+14155552344", }); console.log(incomingPhoneNumber.accountSid); } createIncomingPhoneNumber(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) incoming_phone_number = client.incoming_phone_numbers.create( phone_number="+14155552344" ) print(incoming_phone_number.account_sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Api.V2010.Account; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var incomingPhoneNumber = await IncomingPhoneNumberResource.CreateAsync( phoneNumber: new Twilio.Types.PhoneNumber("+14155552344")); Console.WriteLine(incomingPhoneNumber.AccountSid); } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import com.twilio.type.PhoneNumber; import com.twilio.Twilio; import com.twilio.rest.api.v2010.account.IncomingPhoneNumber; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); IncomingPhoneNumber incomingPhoneNumber = IncomingPhoneNumber.creator(new com.twilio.type.PhoneNumber("+14155552344")).create(); System.out.println(incomingPhoneNumber.getAccountSid()); } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" api "github.com/twilio/twilio-go/rest/api/v2010" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() params := &api.CreateIncomingPhoneNumberParams{} params.SetPhoneNumber("+14155552344") resp, err := client.Api.CreateIncomingPhoneNumber(params) if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { if resp.AccountSid != nil { fmt.Println(*resp.AccountSid) } else { fmt.Println(resp.AccountSid) } } } ``` ```php incomingPhoneNumbers->create([ "phoneNumber" => "+14155552344", ]); print $incoming_phone_number->accountSid; ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) incoming_phone_number = @client .api .v2010 .incoming_phone_numbers .create(phone_number: '+14155552344') puts incoming_phone_number.account_sid ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:core:incoming-phone-numbers:create \ --phone-number +14155552344 ``` ```bash curl -X POST "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/IncomingPhoneNumbers.json" \ --data-urlencode "PhoneNumber=+14155552344" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "address_requirements": "none", "address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "api_version": "2010-04-01", "beta": false, "capabilities": { "voice": true, "sms": false, "mms": true, "fax": false }, "date_created": "Thu, 30 Jul 2015 23:19:04 +0000", "date_updated": "Thu, 30 Jul 2015 23:19:04 +0000", "emergency_status": "Active", "emergency_address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "emergency_address_status": "registered", "friendly_name": "friendly_name", "identity_sid": "RIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "origin": "origin", "phone_number": "+14155552344", "sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sms_application_sid": "APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sms_fallback_method": "GET", "sms_fallback_url": "https://example.com", "sms_method": "GET", "sms_url": "https://example.com", "status_callback": "https://example.com", "status_callback_method": "GET", "trunk_sid": null, "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json", "voice_application_sid": "APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "voice_caller_id_lookup": false, "voice_fallback_method": "GET", "voice_fallback_url": "https://example.com", "voice_method": "GET", "voice_url": "https://example.com", "bundle_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "voice_receive_mode": "voice", "status": "in-use", "type": "local" } ``` Provision a Phone Number with an AddressSid and a BundleSid ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function createIncomingPhoneNumber() { const incomingPhoneNumber = await client.incomingPhoneNumbers.create({ addressSid: "ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", bundleSid: "BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", phoneNumber: "+14155552344", }); console.log(incomingPhoneNumber.accountSid); } createIncomingPhoneNumber(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) incoming_phone_number = client.incoming_phone_numbers.create( address_sid="ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", bundle_sid="BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", phone_number="+14155552344", ) print(incoming_phone_number.account_sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Api.V2010.Account; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var incomingPhoneNumber = await IncomingPhoneNumberResource.CreateAsync( addressSid: "ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", bundleSid: "BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", phoneNumber: new Twilio.Types.PhoneNumber("+14155552344")); Console.WriteLine(incomingPhoneNumber.AccountSid); } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import com.twilio.type.PhoneNumber; import com.twilio.Twilio; import com.twilio.rest.api.v2010.account.IncomingPhoneNumber; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); IncomingPhoneNumber incomingPhoneNumber = IncomingPhoneNumber.creator(new com.twilio.type.PhoneNumber("+14155552344")) .setAddressSid("ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX") .setBundleSid("BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX") .create(); System.out.println(incomingPhoneNumber.getAccountSid()); } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" api "github.com/twilio/twilio-go/rest/api/v2010" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() params := &api.CreateIncomingPhoneNumberParams{} params.SetAddressSid("ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX") params.SetBundleSid("BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX") params.SetPhoneNumber("+14155552344") resp, err := client.Api.CreateIncomingPhoneNumber(params) if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { if resp.AccountSid != nil { fmt.Println(*resp.AccountSid) } else { fmt.Println(resp.AccountSid) } } } ``` ```php incomingPhoneNumbers->create([ "addressSid" => "ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "bundleSid" => "BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "phoneNumber" => "+14155552344", ]); print $incoming_phone_number->accountSid; ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) incoming_phone_number = @client .api .v2010 .incoming_phone_numbers .create( address_sid: 'ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX', bundle_sid: 'BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX', phone_number: '+14155552344' ) puts incoming_phone_number.account_sid ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:core:incoming-phone-numbers:create \ --address-sid ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX \ --bundle-sid BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX \ --phone-number +14155552344 ``` ```bash curl -X POST "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/IncomingPhoneNumbers.json" \ --data-urlencode "AddressSid=ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \ --data-urlencode "BundleSid=BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \ --data-urlencode "PhoneNumber=+14155552344" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "address_requirements": "none", "address_sid": "ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "api_version": "2010-04-01", "beta": false, "capabilities": { "voice": true, "sms": false, "mms": true, "fax": false }, "date_created": "Thu, 30 Jul 2015 23:19:04 +0000", "date_updated": "Thu, 30 Jul 2015 23:19:04 +0000", "emergency_status": "Active", "emergency_address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "emergency_address_status": "registered", "friendly_name": "friendly_name", "identity_sid": "RIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "origin": "origin", "phone_number": "+14155552344", "sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sms_application_sid": "APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sms_fallback_method": "GET", "sms_fallback_url": "https://example.com", "sms_method": "GET", "sms_url": "https://example.com", "status_callback": "https://example.com", "status_callback_method": "GET", "trunk_sid": null, "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json", "voice_application_sid": "APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "voice_caller_id_lookup": false, "voice_fallback_method": "GET", "voice_fallback_url": "https://example.com", "voice_method": "GET", "voice_url": "https://example.com", "bundle_sid": "BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "voice_receive_mode": "voice", "status": "in-use", "type": "local" } ``` Provision a Phone Number with a Voice URL ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function createIncomingPhoneNumber() { const incomingPhoneNumber = await client.incomingPhoneNumbers.create({ phoneNumber: "+14155552344", voiceUrl: "https://www.your-voice-url.com/example", }); console.log(incomingPhoneNumber.accountSid); } createIncomingPhoneNumber(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) incoming_phone_number = client.incoming_phone_numbers.create( voice_url="https://www.your-voice-url.com/example", phone_number="+14155552344", ) print(incoming_phone_number.account_sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Api.V2010.Account; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var incomingPhoneNumber = await IncomingPhoneNumberResource.CreateAsync( voiceUrl: new Uri("https://www.your-voice-url.com/example"), phoneNumber: new Twilio.Types.PhoneNumber("+14155552344")); Console.WriteLine(incomingPhoneNumber.AccountSid); } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import java.net.URI; import com.twilio.type.PhoneNumber; import com.twilio.Twilio; import com.twilio.rest.api.v2010.account.IncomingPhoneNumber; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); IncomingPhoneNumber incomingPhoneNumber = IncomingPhoneNumber.creator(new com.twilio.type.PhoneNumber("+14155552344")) .setVoiceUrl(URI.create("https://www.your-voice-url.com/example")) .create(); System.out.println(incomingPhoneNumber.getAccountSid()); } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" api "github.com/twilio/twilio-go/rest/api/v2010" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() params := &api.CreateIncomingPhoneNumberParams{} params.SetVoiceUrl("https://www.your-voice-url.com/example") params.SetPhoneNumber("+14155552344") resp, err := client.Api.CreateIncomingPhoneNumber(params) if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { if resp.AccountSid != nil { fmt.Println(*resp.AccountSid) } else { fmt.Println(resp.AccountSid) } } } ``` ```php incomingPhoneNumbers->create([ "voiceUrl" => "https://www.your-voice-url.com/example", "phoneNumber" => "+14155552344", ]); print $incoming_phone_number->accountSid; ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) incoming_phone_number = @client .api .v2010 .incoming_phone_numbers .create( voice_url: 'https://www.your-voice-url.com/example', phone_number: '+14155552344' ) puts incoming_phone_number.account_sid ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:core:incoming-phone-numbers:create \ --voice-url https://www.your-voice-url.com/example \ --phone-number +14155552344 ``` ```bash curl -X POST "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/IncomingPhoneNumbers.json" \ --data-urlencode "VoiceUrl=https://www.your-voice-url.com/example" \ --data-urlencode "PhoneNumber=+14155552344" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "address_requirements": "none", "address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "api_version": "2010-04-01", "beta": false, "capabilities": { "voice": true, "sms": false, "mms": true, "fax": false }, "date_created": "Thu, 30 Jul 2015 23:19:04 +0000", "date_updated": "Thu, 30 Jul 2015 23:19:04 +0000", "emergency_status": "Active", "emergency_address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "emergency_address_status": "registered", "friendly_name": "friendly_name", "identity_sid": "RIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "origin": "origin", "phone_number": "+14155552344", "sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sms_application_sid": "APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sms_fallback_method": "GET", "sms_fallback_url": "https://example.com", "sms_method": "GET", "sms_url": "https://example.com", "status_callback": "https://example.com", "status_callback_method": "GET", "trunk_sid": null, "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json", "voice_application_sid": "APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "voice_caller_id_lookup": false, "voice_fallback_method": "GET", "voice_fallback_url": "https://example.com", "voice_method": "GET", "voice_url": "https://www.your-voice-url.com/example", "bundle_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "voice_receive_mode": "voice", "status": "in-use", "type": "local" } ``` Provision a Phone Number with an SMS URL ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function createIncomingPhoneNumber() { const incomingPhoneNumber = await client.incomingPhoneNumbers.create({ phoneNumber: "+14155552344", smsUrl: "https://www.your-sms-url.com/example", }); console.log(incomingPhoneNumber.accountSid); } createIncomingPhoneNumber(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) incoming_phone_number = client.incoming_phone_numbers.create( sms_url="https://www.your-sms-url.com/example", phone_number="+14155552344" ) print(incoming_phone_number.account_sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Api.V2010.Account; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var incomingPhoneNumber = await IncomingPhoneNumberResource.CreateAsync( smsUrl: new Uri("https://www.your-sms-url.com/example"), phoneNumber: new Twilio.Types.PhoneNumber("+14155552344")); Console.WriteLine(incomingPhoneNumber.AccountSid); } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import java.net.URI; import com.twilio.type.PhoneNumber; import com.twilio.Twilio; import com.twilio.rest.api.v2010.account.IncomingPhoneNumber; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); IncomingPhoneNumber incomingPhoneNumber = IncomingPhoneNumber.creator(new com.twilio.type.PhoneNumber("+14155552344")) .setSmsUrl(URI.create("https://www.your-sms-url.com/example")) .create(); System.out.println(incomingPhoneNumber.getAccountSid()); } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" api "github.com/twilio/twilio-go/rest/api/v2010" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() params := &api.CreateIncomingPhoneNumberParams{} params.SetSmsUrl("https://www.your-sms-url.com/example") params.SetPhoneNumber("+14155552344") resp, err := client.Api.CreateIncomingPhoneNumber(params) if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { if resp.AccountSid != nil { fmt.Println(*resp.AccountSid) } else { fmt.Println(resp.AccountSid) } } } ``` ```php incomingPhoneNumbers->create([ "smsUrl" => "https://www.your-sms-url.com/example", "phoneNumber" => "+14155552344", ]); print $incoming_phone_number->accountSid; ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) incoming_phone_number = @client .api .v2010 .incoming_phone_numbers .create( sms_url: 'https://www.your-sms-url.com/example', phone_number: '+14155552344' ) puts incoming_phone_number.account_sid ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:core:incoming-phone-numbers:create \ --sms-url https://www.your-sms-url.com/example \ --phone-number +14155552344 ``` ```bash curl -X POST "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/IncomingPhoneNumbers.json" \ --data-urlencode "SmsUrl=https://www.your-sms-url.com/example" \ --data-urlencode "PhoneNumber=+14155552344" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "address_requirements": "none", "address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "api_version": "2010-04-01", "beta": false, "capabilities": { "voice": true, "sms": false, "mms": true, "fax": false }, "date_created": "Thu, 30 Jul 2015 23:19:04 +0000", "date_updated": "Thu, 30 Jul 2015 23:19:04 +0000", "emergency_status": "Active", "emergency_address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "emergency_address_status": "registered", "friendly_name": "friendly_name", "identity_sid": "RIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "origin": "origin", "phone_number": "+14155552344", "sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sms_application_sid": "APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sms_fallback_method": "GET", "sms_fallback_url": "https://example.com", "sms_method": "GET", "sms_url": "https://www.your-sms-url.com/example", "status_callback": "https://example.com", "status_callback_method": "GET", "trunk_sid": null, "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json", "voice_application_sid": "APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "voice_caller_id_lookup": false, "voice_fallback_method": "GET", "voice_fallback_url": "https://example.com", "voice_method": "GET", "voice_url": "https://example.com", "bundle_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "voice_receive_mode": "voice", "status": "in-use", "type": "local" } ``` ## Fetch an IncomingPhoneNumber resource `GET https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/IncomingPhoneNumbers/{Sid}.json` ### Path parameters ```json [{"name":"AccountSid","in":"path","description":"The SID of the [Account](/docs/iam/api/account) that created the IncomingPhoneNumber resource to fetch.","schema":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AC[0-9a-fA-F]{32}$"},"required":true},{"name":"Sid","in":"path","description":"The Twilio-provided string that uniquely identifies the IncomingPhoneNumber resource to fetch.","schema":{"type":"string","minLength":34,"maxLength":34,"pattern":"^PN[0-9a-fA-F]{32}$"},"required":true}] ``` Fetch an IncomingPhoneNumber ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function fetchIncomingPhoneNumber() { const incomingPhoneNumber = await client .incomingPhoneNumbers("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .fetch(); console.log(incomingPhoneNumber.accountSid); } fetchIncomingPhoneNumber(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) incoming_phone_number = client.incoming_phone_numbers( "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" ).fetch() print(incoming_phone_number.account_sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Api.V2010.Account; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var incomingPhoneNumber = await IncomingPhoneNumberResource.FetchAsync( pathSid: "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"); Console.WriteLine(incomingPhoneNumber.AccountSid); } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import com.twilio.Twilio; import com.twilio.rest.api.v2010.account.IncomingPhoneNumber; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); IncomingPhoneNumber incomingPhoneNumber = IncomingPhoneNumber.fetcher("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa").fetch(); System.out.println(incomingPhoneNumber.getAccountSid()); } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" api "github.com/twilio/twilio-go/rest/api/v2010" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() params := &api.FetchIncomingPhoneNumberParams{} resp, err := client.Api.FetchIncomingPhoneNumber("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", params) if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { if resp.AccountSid != nil { fmt.Println(*resp.AccountSid) } else { fmt.Println(resp.AccountSid) } } } ``` ```php incomingPhoneNumbers("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") ->fetch(); print $incoming_phone_number->accountSid; ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) incoming_phone_number = @client .api .v2010 .incoming_phone_numbers('PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa') .fetch puts incoming_phone_number.account_sid ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:core:incoming-phone-numbers:fetch \ --sid PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa ``` ```bash curl -X GET "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/IncomingPhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "address_requirements": "none", "address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "api_version": "2010-04-01", "beta": false, "capabilities": { "voice": true, "sms": false, "mms": true, "fax": false }, "date_created": "Thu, 30 Jul 2015 23:19:04 +0000", "date_updated": "Thu, 30 Jul 2015 23:19:04 +0000", "emergency_status": "Active", "emergency_address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "emergency_address_status": "registered", "friendly_name": "(808) 925-5327", "identity_sid": "RIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "origin": "origin", "phone_number": "+18089255327", "sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sms_application_sid": "", "sms_fallback_method": "POST", "sms_fallback_url": "", "sms_method": "POST", "sms_url": "", "status_callback": "", "status_callback_method": "POST", "trunk_sid": null, "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json", "voice_application_sid": "", "voice_caller_id_lookup": false, "voice_fallback_method": "POST", "voice_fallback_url": null, "voice_method": "POST", "voice_url": null, "voice_receive_mode": "voice", "status": "in-use", "bundle_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "type": "local" } ``` ## Read multiple IncomingPhoneNumber resources `GET https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/IncomingPhoneNumbers.json` ### Path parameters ```json [{"name":"AccountSid","in":"path","description":"The SID of the [Account](/docs/iam/api/account) that created the IncomingPhoneNumber resources to read.","schema":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AC[0-9a-fA-F]{32}$"},"required":true}] ``` ### Query parameters ```json [{"name":"Beta","in":"query","description":"Whether to include phone numbers new to the Twilio platform. Can be: `true` or `false` and the default is `true`.","schema":{"type":"boolean"},"examples":{"readFull":{"value":"true"},"readEmpty":{"value":"true"}}},{"name":"FriendlyName","in":"query","description":"A string that identifies the IncomingPhoneNumber resources to read.","schema":{"type":"string"},"x-twilio":{"pii":{"handling":"standard","deleteSla":30}},"examples":{"readFull":{"value":"friendly_name"},"readEmpty":{"value":"friendly_name"}}},{"name":"PhoneNumber","in":"query","description":"The phone numbers of the IncomingPhoneNumber resources to read. You can specify partial numbers and use '*' as a wildcard for any digit.","schema":{"type":"string","format":"phone-number"},"examples":{"readFull":{"value":"+19876543210"},"readEmpty":{"value":"+19876543210"}}},{"name":"Origin","in":"query","description":"Whether to include phone numbers based on their origin. Can be: `twilio` or `hosted`. By default, phone numbers of all origin are included.","schema":{"type":"string"}},{"name":"PageSize","in":"query","description":"How many resources to return in each list page. The default is 50, and the maximum is 1000.","schema":{"type":"integer","format":"int64","minimum":1,"maximum":1000}},{"name":"Page","in":"query","description":"The page index. This value is simply for client state.","schema":{"type":"integer","minimum":0}},{"name":"PageToken","in":"query","description":"The page token. This is provided by the API.","schema":{"type":"string"}}] ``` The following examples demonstrate how to list and filter IncomingPhoneNumber resources: List all IncomingPhoneNumber resources for your account ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function listIncomingPhoneNumber() { const incomingPhoneNumbers = await client.incomingPhoneNumbers.list({ limit: 20, }); incomingPhoneNumbers.forEach((i) => console.log(i.accountSid)); } listIncomingPhoneNumber(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) incoming_phone_numbers = client.incoming_phone_numbers.list(limit=20) for record in incoming_phone_numbers: print(record.account_sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Api.V2010.Account; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var incomingPhoneNumbers = await IncomingPhoneNumberResource.ReadAsync(limit: 20); foreach (var record in incomingPhoneNumbers) { Console.WriteLine(record.AccountSid); } } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import com.twilio.Twilio; import com.twilio.rest.api.v2010.account.IncomingPhoneNumber; import com.twilio.base.ResourceSet; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); ResourceSet incomingPhoneNumbers = IncomingPhoneNumber.reader().limit(20).read(); for (IncomingPhoneNumber record : incomingPhoneNumbers) { System.out.println(record.getAccountSid()); } } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" api "github.com/twilio/twilio-go/rest/api/v2010" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() params := &api.ListIncomingPhoneNumberParams{} params.SetLimit(20) resp, err := client.Api.ListIncomingPhoneNumber(params) if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { for record := range resp { if resp[record].AccountSid != nil { fmt.Println(*resp[record].AccountSid) } else { fmt.Println(resp[record].AccountSid) } } } } ``` ```php incomingPhoneNumbers->read([], 20); foreach ($incomingPhoneNumbers as $record) { print $record->accountSid; } ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) incoming_phone_numbers = @client .api .v2010 .incoming_phone_numbers .list(limit: 20) incoming_phone_numbers.each do |record| puts record.account_sid end ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:core:incoming-phone-numbers:list ``` ```bash curl -X GET "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/IncomingPhoneNumbers.json?PageSize=20" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "end": 0, "first_page_uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers.json?FriendlyName=friendly_name&Beta=true&PhoneNumber=%2B19876543210&PageSize=50&Page=0", "incoming_phone_numbers": [ { "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "address_requirements": "none", "address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "api_version": "2010-04-01", "beta": null, "capabilities": { "voice": true, "sms": false, "mms": true, "fax": false }, "date_created": "Thu, 30 Jul 2015 23:19:04 +0000", "date_updated": "Thu, 30 Jul 2015 23:19:04 +0000", "emergency_status": "Active", "emergency_address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "emergency_address_status": "registered", "friendly_name": "(808) 925-5327", "identity_sid": "RIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "origin": "origin", "phone_number": "+18089255327", "sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sms_application_sid": "", "sms_fallback_method": "POST", "sms_fallback_url": "", "sms_method": "POST", "sms_url": "", "status_callback": "", "status_callback_method": "POST", "trunk_sid": null, "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json", "voice_application_sid": "", "voice_caller_id_lookup": false, "voice_fallback_method": "POST", "voice_fallback_url": null, "voice_method": "POST", "voice_url": null, "bundle_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "voice_receive_mode": "voice", "status": "in-use", "type": "local" } ], "next_page_uri": null, "page": 0, "page_size": 50, "previous_page_uri": null, "start": 0, "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers.json?FriendlyName=friendly_name&Beta=true&PhoneNumber=%2B19876543210&PageSize=50&Page=0" } ``` Filter IncomingPhoneNumbers with exact match ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function listIncomingPhoneNumber() { const incomingPhoneNumbers = await client.incomingPhoneNumbers.list({ phoneNumber: "+14158675310", limit: 20, }); incomingPhoneNumbers.forEach((i) => console.log(i.accountSid)); } listIncomingPhoneNumber(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) incoming_phone_numbers = client.incoming_phone_numbers.list( phone_number="+14158675310", limit=20 ) for record in incoming_phone_numbers: print(record.account_sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Api.V2010.Account; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var incomingPhoneNumbers = await IncomingPhoneNumberResource.ReadAsync( phoneNumber: new Twilio.Types.PhoneNumber("+14158675310"), limit: 20); foreach (var record in incomingPhoneNumbers) { Console.WriteLine(record.AccountSid); } } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import com.twilio.type.PhoneNumber; import com.twilio.Twilio; import com.twilio.rest.api.v2010.account.IncomingPhoneNumber; import com.twilio.base.ResourceSet; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); ResourceSet incomingPhoneNumbers = IncomingPhoneNumber.reader() .setPhoneNumber(new com.twilio.type.PhoneNumber("+14158675310")) .limit(20) .read(); for (IncomingPhoneNumber record : incomingPhoneNumbers) { System.out.println(record.getAccountSid()); } } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" api "github.com/twilio/twilio-go/rest/api/v2010" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() params := &api.ListIncomingPhoneNumberParams{} params.SetPhoneNumber("+14158675310") params.SetLimit(20) resp, err := client.Api.ListIncomingPhoneNumber(params) if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { for record := range resp { if resp[record].AccountSid != nil { fmt.Println(*resp[record].AccountSid) } else { fmt.Println(resp[record].AccountSid) } } } } ``` ```php incomingPhoneNumbers->read( ["phoneNumber" => "+14158675310"], 20 ); foreach ($incomingPhoneNumbers as $record) { print $record->accountSid; } ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) incoming_phone_numbers = @client .api .v2010 .incoming_phone_numbers .list( phone_number: '+14158675310', limit: 20 ) incoming_phone_numbers.each do |record| puts record.account_sid end ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:core:incoming-phone-numbers:list \ --phone-number +14158675310 ``` ```bash curl -X GET "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/IncomingPhoneNumbers.json?PhoneNumber=%2B14158675310&PageSize=20" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "end": 0, "first_page_uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers.json?FriendlyName=friendly_name&Beta=true&PhoneNumber=%2B19876543210&PageSize=50&Page=0", "incoming_phone_numbers": [ { "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "address_requirements": "none", "address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "api_version": "2010-04-01", "beta": null, "capabilities": { "voice": true, "sms": false, "mms": true, "fax": false }, "date_created": "Thu, 30 Jul 2015 23:19:04 +0000", "date_updated": "Thu, 30 Jul 2015 23:19:04 +0000", "emergency_status": "Active", "emergency_address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "emergency_address_status": "registered", "friendly_name": "(808) 925-5327", "identity_sid": "RIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "origin": "origin", "phone_number": "+18089255327", "sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sms_application_sid": "", "sms_fallback_method": "POST", "sms_fallback_url": "", "sms_method": "POST", "sms_url": "", "status_callback": "", "status_callback_method": "POST", "trunk_sid": null, "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json", "voice_application_sid": "", "voice_caller_id_lookup": false, "voice_fallback_method": "POST", "voice_fallback_url": null, "voice_method": "POST", "voice_url": null, "bundle_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "voice_receive_mode": "voice", "status": "in-use", "type": "local" } ], "next_page_uri": null, "page": 0, "page_size": 50, "previous_page_uri": null, "start": 0, "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers.json?FriendlyName=friendly_name&Beta=true&PhoneNumber=%2B19876543210&PageSize=50&Page=0" } ``` Filter IncomingPhoneNumbers with partial match ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function listIncomingPhoneNumber() { const incomingPhoneNumbers = await client.incomingPhoneNumbers.list({ phoneNumber: "867", limit: 20, }); incomingPhoneNumbers.forEach((i) => console.log(i.accountSid)); } listIncomingPhoneNumber(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) incoming_phone_numbers = client.incoming_phone_numbers.list( phone_number="867", limit=20 ) for record in incoming_phone_numbers: print(record.account_sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Api.V2010.Account; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var incomingPhoneNumbers = await IncomingPhoneNumberResource.ReadAsync( phoneNumber: new Twilio.Types.PhoneNumber("867"), limit: 20); foreach (var record in incomingPhoneNumbers) { Console.WriteLine(record.AccountSid); } } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import com.twilio.type.PhoneNumber; import com.twilio.Twilio; import com.twilio.rest.api.v2010.account.IncomingPhoneNumber; import com.twilio.base.ResourceSet; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); ResourceSet incomingPhoneNumbers = IncomingPhoneNumber.reader().setPhoneNumber(new com.twilio.type.PhoneNumber("867")).limit(20).read(); for (IncomingPhoneNumber record : incomingPhoneNumbers) { System.out.println(record.getAccountSid()); } } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" api "github.com/twilio/twilio-go/rest/api/v2010" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() params := &api.ListIncomingPhoneNumberParams{} params.SetPhoneNumber("867") params.SetLimit(20) resp, err := client.Api.ListIncomingPhoneNumber(params) if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { for record := range resp { if resp[record].AccountSid != nil { fmt.Println(*resp[record].AccountSid) } else { fmt.Println(resp[record].AccountSid) } } } } ``` ```php incomingPhoneNumbers->read( ["phoneNumber" => "867"], 20 ); foreach ($incomingPhoneNumbers as $record) { print $record->accountSid; } ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) incoming_phone_numbers = @client .api .v2010 .incoming_phone_numbers .list( phone_number: '867', limit: 20 ) incoming_phone_numbers.each do |record| puts record.account_sid end ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:core:incoming-phone-numbers:list \ --phone-number 867 ``` ```bash curl -X GET "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/IncomingPhoneNumbers.json?PhoneNumber=867&PageSize=20" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "end": 0, "first_page_uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers.json?FriendlyName=friendly_name&Beta=true&PhoneNumber=%2B19876543210&PageSize=50&Page=0", "incoming_phone_numbers": [ { "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "address_requirements": "none", "address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "api_version": "2010-04-01", "beta": null, "capabilities": { "voice": true, "sms": false, "mms": true, "fax": false }, "date_created": "Thu, 30 Jul 2015 23:19:04 +0000", "date_updated": "Thu, 30 Jul 2015 23:19:04 +0000", "emergency_status": "Active", "emergency_address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "emergency_address_status": "registered", "friendly_name": "(808) 925-5327", "identity_sid": "RIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "origin": "origin", "phone_number": "+18089255327", "sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sms_application_sid": "", "sms_fallback_method": "POST", "sms_fallback_url": "", "sms_method": "POST", "sms_url": "", "status_callback": "", "status_callback_method": "POST", "trunk_sid": null, "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json", "voice_application_sid": "", "voice_caller_id_lookup": false, "voice_fallback_method": "POST", "voice_fallback_url": null, "voice_method": "POST", "voice_url": null, "bundle_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "voice_receive_mode": "voice", "status": "in-use", "type": "local" } ], "next_page_uri": null, "page": 0, "page_size": 50, "previous_page_uri": null, "start": 0, "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers.json?FriendlyName=friendly_name&Beta=true&PhoneNumber=%2B19876543210&PageSize=50&Page=0" } ``` ## Update an IncomingPhoneNumber resource `POST https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/IncomingPhoneNumbers/{Sid}.json` ### Path parameters ```json [{"name":"AccountSid","in":"path","description":"The SID of the [Account](/docs/iam/api/account) that created the IncomingPhoneNumber resource to update. For more information, see [Exchanging Numbers Between Subaccounts](/docs/iam/api/subaccounts#exchanging-numbers).","schema":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AC[0-9a-fA-F]{32}$"},"required":true},{"name":"Sid","in":"path","description":"The Twilio-provided string that uniquely identifies the IncomingPhoneNumber resource to update.","schema":{"type":"string","minLength":34,"maxLength":34,"pattern":"^PN[0-9a-fA-F]{32}$"},"required":true}] ``` ### Request body parameters ```json {"schema":{"type":"object","title":"UpdateIncomingPhoneNumberRequest","properties":{"AccountSid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AC[0-9a-fA-F]{32}$","description":"The SID of the [Account](/docs/iam/api/account) that created the IncomingPhoneNumber resource to update. For more information, see [Exchanging Numbers Between Subaccounts](/docs/iam/api/subaccounts#exchanging-numbers)."},"ApiVersion":{"type":"string","description":"The API version to use for incoming calls made to the phone number. The default is `2010-04-01`."},"FriendlyName":{"type":"string","description":"A descriptive string that you created to describe this phone number. It can be up to 64 characters long. By default, this is a formatted version of the phone number.","x-twilio":{"pii":{"handling":"standard","deleteSla":30}}},"SmsApplicationSid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AP[0-9a-fA-F]{32}$","description":"The SID of the application that should handle SMS messages sent to the number. If an `sms_application_sid` is present, we ignore all of the `sms_*_url` urls and use those set on the application."},"SmsFallbackMethod":{"type":"string","format":"http-method","enum":["GET","POST"],"description":"The HTTP method that we should use to call `sms_fallback_url`. Can be: `GET` or `POST` and defaults to `POST`."},"SmsFallbackUrl":{"type":"string","format":"uri","description":"The URL that we should call when an error occurs while requesting or executing the TwiML defined by `sms_url`."},"SmsMethod":{"type":"string","format":"http-method","enum":["GET","POST"],"description":"The HTTP method that we should use to call `sms_url`. Can be: `GET` or `POST` and defaults to `POST`."},"SmsUrl":{"type":"string","format":"uri","description":"The URL we should call when the phone number receives an incoming SMS message."},"StatusCallback":{"type":"string","format":"uri","description":"The URL we should call using the `status_callback_method` to send status information to your application."},"StatusCallbackMethod":{"type":"string","format":"http-method","enum":["GET","POST"],"description":"The HTTP method we should use to call `status_callback`. Can be: `GET` or `POST` and defaults to `POST`."},"VoiceApplicationSid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AP[0-9a-fA-F]{32}$","description":"The SID of the application we should use to handle phone calls to the phone number. If a `voice_application_sid` is present, we ignore all of the voice urls and use only those set on the application. Setting a `voice_application_sid` will automatically delete your `trunk_sid` and vice versa."},"VoiceCallerIdLookup":{"type":"boolean","description":"Whether to lookup the caller's name from the CNAM database and post it to your app. Can be: `true` or `false` and defaults to `false`."},"VoiceFallbackMethod":{"type":"string","format":"http-method","enum":["GET","POST"],"description":"The HTTP method that we should use to call `voice_fallback_url`. Can be: `GET` or `POST` and defaults to `POST`."},"VoiceFallbackUrl":{"type":"string","format":"uri","description":"The URL that we should call when an error occurs retrieving or executing the TwiML requested by `url`."},"VoiceMethod":{"type":"string","format":"http-method","enum":["GET","POST"],"description":"The HTTP method that we should use to call `voice_url`. Can be: `GET` or `POST` and defaults to `POST`."},"VoiceUrl":{"type":"string","format":"uri","description":"The URL that we should call to answer a call to the phone number. The `voice_url` will not be called if a `voice_application_sid` or a `trunk_sid` is set."},"EmergencyStatus":{"type":"string","enum":["Active","Inactive"],"description":"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.","refName":"incoming_phone_number_enum_emergency_status","modelName":"incoming_phone_number_enum_emergency_status"},"EmergencyAddressSid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AD[0-9a-fA-F]{32}$","description":"The SID of the emergency address configuration to use for emergency calling from this phone number."},"TrunkSid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^TK[0-9a-fA-F]{32}$","description":"The SID of the Trunk we should use to handle phone calls to the phone number. If a `trunk_sid` is present, we ignore all of the voice urls and voice applications and use only those set on the Trunk. Setting a `trunk_sid` will automatically delete your `voice_application_sid` and vice versa."},"VoiceReceiveMode":{"type":"string","enum":["voice","fax"],"refName":"incoming_phone_number_enum_voice_receive_mode","modelName":"incoming_phone_number_enum_voice_receive_mode"},"IdentitySid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^RI[0-9a-fA-F]{32}$","description":"The SID of the Identity resource that we should associate with the phone number. Some regions require an identity to meet local regulations."},"AddressSid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AD[0-9a-fA-F]{32}$","description":"The SID of the Address resource we should associate with the phone number. Some regions require addresses to meet local regulations."},"BundleSid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^BU[0-9a-fA-F]{32}$","description":"The SID of the Bundle resource that you associate with the phone number. Some regions require a Bundle to meet local Regulations."}}},"examples":{"update":{"value":{"lang":"json","value":"{\n \"AccountSid\": \"ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"AddressSid\": \"ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"ApiVersion\": \"api_version\",\n \"EmergencyStatus\": \"Inactive\",\n \"EmergencyAddressSid\": \"ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"FriendlyName\": \"friendly_name\",\n \"IdentitySid\": \"RIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"SmsApplicationSid\": \"APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"SmsFallbackMethod\": \"GET\",\n \"SmsFallbackUrl\": \"https://example.com\",\n \"SmsMethod\": \"GET\",\n \"SmsUrl\": \"https://example.com\",\n \"StatusCallback\": \"https://example.com\",\n \"StatusCallbackMethod\": \"GET\",\n \"VoiceApplicationSid\": \"APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"VoiceCallerIdLookup\": \"true\",\n \"VoiceFallbackMethod\": \"GET\",\n \"VoiceFallbackUrl\": \"https://example.com\",\n \"VoiceMethod\": \"GET\",\n \"VoiceUrl\": \"https://example.com\",\n \"VoiceReceiveMode\": \"voice\",\n \"BundleSid\": \"BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"\n}","meta":"","code":"{\n \"AccountSid\": \"ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"AddressSid\": \"ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"ApiVersion\": \"api_version\",\n \"EmergencyStatus\": \"Inactive\",\n \"EmergencyAddressSid\": \"ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"FriendlyName\": \"friendly_name\",\n \"IdentitySid\": \"RIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"SmsApplicationSid\": \"APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"SmsFallbackMethod\": \"GET\",\n \"SmsFallbackUrl\": \"https://example.com\",\n \"SmsMethod\": \"GET\",\n \"SmsUrl\": \"https://example.com\",\n \"StatusCallback\": \"https://example.com\",\n \"StatusCallbackMethod\": \"GET\",\n \"VoiceApplicationSid\": \"APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"VoiceCallerIdLookup\": \"true\",\n \"VoiceFallbackMethod\": \"GET\",\n \"VoiceFallbackUrl\": \"https://example.com\",\n \"VoiceMethod\": \"GET\",\n \"VoiceUrl\": \"https://example.com\",\n \"VoiceReceiveMode\": \"voice\",\n \"BundleSid\": \"BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"\n}","tokens":[["{","#C9D1D9"],"\n ",["\"AccountSid\"","#7EE787"],[":","#C9D1D9"]," ",["\"ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"AddressSid\"","#7EE787"],[":","#C9D1D9"]," ",["\"ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"ApiVersion\"","#7EE787"],[":","#C9D1D9"]," ",["\"api_version\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"EmergencyStatus\"","#7EE787"],[":","#C9D1D9"]," ",["\"Inactive\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"EmergencyAddressSid\"","#7EE787"],[":","#C9D1D9"]," ",["\"ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"FriendlyName\"","#7EE787"],[":","#C9D1D9"]," ",["\"friendly_name\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"IdentitySid\"","#7EE787"],[":","#C9D1D9"]," ",["\"RIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"SmsApplicationSid\"","#7EE787"],[":","#C9D1D9"]," ",["\"APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"SmsFallbackMethod\"","#7EE787"],[":","#C9D1D9"]," ",["\"GET\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"SmsFallbackUrl\"","#7EE787"],[":","#C9D1D9"]," ",["\"https://example.com\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"SmsMethod\"","#7EE787"],[":","#C9D1D9"]," ",["\"GET\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"SmsUrl\"","#7EE787"],[":","#C9D1D9"]," ",["\"https://example.com\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"StatusCallback\"","#7EE787"],[":","#C9D1D9"]," ",["\"https://example.com\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"StatusCallbackMethod\"","#7EE787"],[":","#C9D1D9"]," ",["\"GET\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"VoiceApplicationSid\"","#7EE787"],[":","#C9D1D9"]," ",["\"APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"VoiceCallerIdLookup\"","#7EE787"],[":","#C9D1D9"]," ",["\"true\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"VoiceFallbackMethod\"","#7EE787"],[":","#C9D1D9"]," ",["\"GET\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"VoiceFallbackUrl\"","#7EE787"],[":","#C9D1D9"]," ",["\"https://example.com\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"VoiceMethod\"","#7EE787"],[":","#C9D1D9"]," ",["\"GET\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"VoiceUrl\"","#7EE787"],[":","#C9D1D9"]," ",["\"https://example.com\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"VoiceReceiveMode\"","#7EE787"],[":","#C9D1D9"]," ",["\"voice\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BundleSid\"","#7EE787"],[":","#C9D1D9"]," ",["\"BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","#A5D6FF"],"\n",["}","#C9D1D9"]],"annotations":[],"themeName":"github-dark","style":{"color":"#c9d1d9","background":"#0d1117"}}}},"encodingType":"application/x-www-form-urlencoded","conditionalParameterMap":{}} ``` The following examples demonstrate how to update IncomingPhoneNumber resources with different configurations: Update IncomingPhoneNumber to include an AddressSid and a BundleSid ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function updateIncomingPhoneNumber() { const incomingPhoneNumber = await client .incomingPhoneNumbers("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .update({ addressSid: "ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", bundleSid: "BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", }); console.log(incomingPhoneNumber.accountSid); } updateIncomingPhoneNumber(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) incoming_phone_number = client.incoming_phone_numbers( "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" ).update( address_sid="ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", bundle_sid="BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", ) print(incoming_phone_number.account_sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Api.V2010.Account; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var incomingPhoneNumber = await IncomingPhoneNumberResource.UpdateAsync( addressSid: "ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", bundleSid: "BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", pathSid: "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"); Console.WriteLine(incomingPhoneNumber.AccountSid); } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import com.twilio.Twilio; import com.twilio.rest.api.v2010.account.IncomingPhoneNumber; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); IncomingPhoneNumber incomingPhoneNumber = IncomingPhoneNumber.updater("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .setAddressSid("ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX") .setBundleSid("BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX") .update(); System.out.println(incomingPhoneNumber.getAccountSid()); } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" api "github.com/twilio/twilio-go/rest/api/v2010" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() params := &api.UpdateIncomingPhoneNumberParams{} params.SetAddressSid("ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX") params.SetBundleSid("BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX") resp, err := client.Api.UpdateIncomingPhoneNumber("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", params) if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { if resp.AccountSid != nil { fmt.Println(*resp.AccountSid) } else { fmt.Println(resp.AccountSid) } } } ``` ```php incomingPhoneNumbers("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") ->update([ "addressSid" => "ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "bundleSid" => "BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", ]); print $incoming_phone_number->accountSid; ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) incoming_phone_number = @client .api .v2010 .incoming_phone_numbers('PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa') .update( address_sid: 'ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX', bundle_sid: 'BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' ) puts incoming_phone_number.account_sid ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:core:incoming-phone-numbers:update \ --sid PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa \ --address-sid ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX \ --bundle-sid BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX ``` ```bash curl -X POST "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/IncomingPhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json" \ --data-urlencode "AddressSid=ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \ --data-urlencode "BundleSid=BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "address_requirements": "none", "address_sid": "ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "api_version": "2010-04-01", "beta": false, "capabilities": { "voice": true, "sms": false, "mms": true, "fax": false }, "date_created": "Thu, 30 Jul 2015 23:19:04 +0000", "date_updated": "Thu, 30 Jul 2015 23:19:04 +0000", "emergency_status": "Inactive", "emergency_address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "emergency_address_status": "registered", "friendly_name": "(808) 925-5327", "identity_sid": "RIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "origin": "origin", "phone_number": "+18089255327", "sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sms_application_sid": "", "sms_fallback_method": "POST", "sms_fallback_url": "", "sms_method": "POST", "sms_url": "", "status_callback": "", "status_callback_method": "POST", "trunk_sid": null, "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json", "voice_application_sid": "", "voice_caller_id_lookup": true, "voice_fallback_method": "POST", "voice_fallback_url": null, "voice_method": "POST", "voice_url": null, "voice_receive_mode": "voice", "status": "in-use", "bundle_sid": "BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "type": "local" } ``` Update IncomingPhoneNumber to use a new Voice URL ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function updateIncomingPhoneNumber() { const incomingPhoneNumber = await client .incomingPhoneNumbers("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .update({ voiceUrl: "https://www.your-new-voice-url.com/example" }); console.log(incomingPhoneNumber.accountSid); } updateIncomingPhoneNumber(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) incoming_phone_number = client.incoming_phone_numbers( "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" ).update(voice_url="https://www.your-new-voice-url.com/example") print(incoming_phone_number.account_sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Api.V2010.Account; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var incomingPhoneNumber = await IncomingPhoneNumberResource.UpdateAsync( voiceUrl: new Uri("https://www.your-new-voice-url.com/example"), pathSid: "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"); Console.WriteLine(incomingPhoneNumber.AccountSid); } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import java.net.URI; import com.twilio.Twilio; import com.twilio.rest.api.v2010.account.IncomingPhoneNumber; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); IncomingPhoneNumber incomingPhoneNumber = IncomingPhoneNumber.updater("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .setVoiceUrl(URI.create("https://www.your-new-voice-url.com/example")) .update(); System.out.println(incomingPhoneNumber.getAccountSid()); } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" api "github.com/twilio/twilio-go/rest/api/v2010" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() params := &api.UpdateIncomingPhoneNumberParams{} params.SetVoiceUrl("https://www.your-new-voice-url.com/example") resp, err := client.Api.UpdateIncomingPhoneNumber("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", params) if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { if resp.AccountSid != nil { fmt.Println(*resp.AccountSid) } else { fmt.Println(resp.AccountSid) } } } ``` ```php incomingPhoneNumbers("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") ->update(["voiceUrl" => "https://www.your-new-voice-url.com/example"]); print $incoming_phone_number->accountSid; ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) incoming_phone_number = @client .api .v2010 .incoming_phone_numbers('PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa') .update( voice_url: 'https://www.your-new-voice-url.com/example' ) puts incoming_phone_number.account_sid ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:core:incoming-phone-numbers:update \ --sid PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa \ --voice-url https://www.your-new-voice-url.com/example ``` ```bash curl -X POST "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/IncomingPhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json" \ --data-urlencode "VoiceUrl=https://www.your-new-voice-url.com/example" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "address_requirements": "none", "address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "api_version": "2010-04-01", "beta": false, "capabilities": { "voice": true, "sms": false, "mms": true, "fax": false }, "date_created": "Thu, 30 Jul 2015 23:19:04 +0000", "date_updated": "Thu, 30 Jul 2015 23:19:04 +0000", "emergency_status": "Inactive", "emergency_address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "emergency_address_status": "registered", "friendly_name": "(808) 925-5327", "identity_sid": "RIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "origin": "origin", "phone_number": "+18089255327", "sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sms_application_sid": "", "sms_fallback_method": "POST", "sms_fallback_url": "", "sms_method": "POST", "sms_url": "", "status_callback": "", "status_callback_method": "POST", "trunk_sid": null, "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json", "voice_application_sid": "", "voice_caller_id_lookup": true, "voice_fallback_method": "POST", "voice_fallback_url": null, "voice_method": "POST", "voice_url": "https://www.your-new-voice-url.com/example", "voice_receive_mode": "voice", "status": "in-use", "bundle_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "type": "local" } ``` Update IncomingPhoneNumber to use a new SMS URL ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function updateIncomingPhoneNumber() { const incomingPhoneNumber = await client .incomingPhoneNumbers("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .update({ smsUrl: "https://www.your-new-sms-url.com/example" }); console.log(incomingPhoneNumber.accountSid); } updateIncomingPhoneNumber(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) incoming_phone_number = client.incoming_phone_numbers( "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" ).update(sms_url="https://www.your-new-sms-url.com/example") print(incoming_phone_number.account_sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Api.V2010.Account; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var incomingPhoneNumber = await IncomingPhoneNumberResource.UpdateAsync( smsUrl: new Uri("https://www.your-new-sms-url.com/example"), pathSid: "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"); Console.WriteLine(incomingPhoneNumber.AccountSid); } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import java.net.URI; import com.twilio.Twilio; import com.twilio.rest.api.v2010.account.IncomingPhoneNumber; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); IncomingPhoneNumber incomingPhoneNumber = IncomingPhoneNumber.updater("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .setSmsUrl(URI.create("https://www.your-new-sms-url.com/example")) .update(); System.out.println(incomingPhoneNumber.getAccountSid()); } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" api "github.com/twilio/twilio-go/rest/api/v2010" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() params := &api.UpdateIncomingPhoneNumberParams{} params.SetSmsUrl("https://www.your-new-sms-url.com/example") resp, err := client.Api.UpdateIncomingPhoneNumber("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", params) if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { if resp.AccountSid != nil { fmt.Println(*resp.AccountSid) } else { fmt.Println(resp.AccountSid) } } } ``` ```php incomingPhoneNumbers("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") ->update(["smsUrl" => "https://www.your-new-sms-url.com/example"]); print $incoming_phone_number->accountSid; ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) incoming_phone_number = @client .api .v2010 .incoming_phone_numbers('PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa') .update(sms_url: 'https://www.your-new-sms-url.com/example') puts incoming_phone_number.account_sid ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:core:incoming-phone-numbers:update \ --sid PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa \ --sms-url https://www.your-new-sms-url.com/example ``` ```bash curl -X POST "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/IncomingPhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json" \ --data-urlencode "SmsUrl=https://www.your-new-sms-url.com/example" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "address_requirements": "none", "address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "api_version": "2010-04-01", "beta": false, "capabilities": { "voice": true, "sms": false, "mms": true, "fax": false }, "date_created": "Thu, 30 Jul 2015 23:19:04 +0000", "date_updated": "Thu, 30 Jul 2015 23:19:04 +0000", "emergency_status": "Inactive", "emergency_address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "emergency_address_status": "registered", "friendly_name": "(808) 925-5327", "identity_sid": "RIaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "origin": "origin", "phone_number": "+18089255327", "sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sms_application_sid": "", "sms_fallback_method": "POST", "sms_fallback_url": "", "sms_method": "POST", "sms_url": "https://www.your-new-sms-url.com/example", "status_callback": "", "status_callback_method": "POST", "trunk_sid": null, "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/IncomingPhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json", "voice_application_sid": "", "voice_caller_id_lookup": true, "voice_fallback_method": "POST", "voice_fallback_url": null, "voice_method": "POST", "voice_url": null, "voice_receive_mode": "voice", "status": "in-use", "bundle_sid": "BUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "type": "local" } ``` ## Delete an IncomingPhoneNumber resource `DELETE https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/IncomingPhoneNumbers/{Sid}.json` Deleting an IncomingPhoneNumber releases it from your account. Twilio will no longer answer calls to this number and will stop charging the monthly fee. Twilio might reclaim and assign the number to another customer, so delete numbers with caution. If you make a mistake, contact [Twilio Support](https://help.twilio.com/). We might be able to give you the number back. ### Path parameters ```json [{"name":"AccountSid","in":"path","description":"The SID of the [Account](/docs/iam/api/account) that created the IncomingPhoneNumber resources to delete.","schema":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AC[0-9a-fA-F]{32}$"},"required":true},{"name":"Sid","in":"path","description":"The Twilio-provided string that uniquely identifies the IncomingPhoneNumber resource to delete.","schema":{"type":"string","minLength":34,"maxLength":34,"pattern":"^PN[0-9a-fA-F]{32}$"},"required":true}] ``` Delete an IncomingPhoneNumber ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function deleteIncomingPhoneNumber() { await client .incomingPhoneNumbers("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .remove(); } deleteIncomingPhoneNumber(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) client.incoming_phone_numbers("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa").delete() ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Api.V2010.Account; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); await IncomingPhoneNumberResource.DeleteAsync( pathSid: "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"); } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import com.twilio.Twilio; import com.twilio.rest.api.v2010.account.IncomingPhoneNumber; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); IncomingPhoneNumber.deleter("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa").delete(); } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" api "github.com/twilio/twilio-go/rest/api/v2010" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() params := &api.DeleteIncomingPhoneNumberParams{} err := client.Api.DeleteIncomingPhoneNumber("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", params) if err != nil { fmt.Println(err.Error()) os.Exit(1) } } ``` ```php incomingPhoneNumbers("PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa")->delete(); ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) @client .api .v2010 .incoming_phone_numbers('PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa') .delete ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:core:incoming-phone-numbers:remove \ --sid PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa ``` ```bash curl -X DELETE "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/IncomingPhoneNumbers/PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ```