Sign in
Incoming Phone Numbers

Create an Incoming Phone Number

Purchases an available number and provisions it as an Incoming Phone Number in the account. Search first with Available Phone Numbers, or use SignalWire REST Purchase phone number for a JSON request. To register a number you already own instead of purchasing inventory, use Imported Phone Numbers.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Numbers.

Learn more about API scopes.

post/Accounts/{AccountSid}/IncomingPhoneNumbers

Path parameters

AccountSidstring uuid required

Universal Unique Identifier.

The unique identifier for the account that is associated with this phone number.

Response

Response returned when an incoming phone number is created.

account_idstring uuid required

Universal Unique Identifier.

account_sidstring uuid required

Universal Unique Identifier.

address_requirements'none' | 'any' | 'local' | 'foreign' required

Address requirements.

address_sidstring nullable required

The unique identifier for the address associated with this phone number. Always null.

api_versionstring required

The version of the SignalWire API.

betaboolean required

New numbers on SignalWire are marked as beta. Always false.

country_codestring required

The ISO 3166-1 alpha-2 country code for this phone number.

date_createdstring required

The date, in RFC 2822 format, this phone number was created.

date_updatedstring required

The date, in RFC 2822 format, this phone number was updated.

emergency_address_sidstring nullable required

The unique identifier of the address associated with E911 for this phone number, or null if not set.

emergency_statusstring required

Whether the phone route has an active E911 address associated. 'Active' or 'Inactive'.

friendly_namestring required

A formatted version of the number.

identity_sidstring nullable required

The unique identifier for the identity associated with this phone number. Always null.

origin'signalwire' | 'hosted' required

Phone number origin.

phone_numberstring required

The incoming number in E.164 format.

sidstring required

The unique identifier for this phone number.

sms_application_sidstring nullable required

The unique identifier for the application associated with SMS handling on this phone number, or null if not set.

sms_fallback_methodstring required

Whether the request to SmsFallbackUrl is a GET or a POST.

sms_fallback_urlstring nullable required

The URL to request if errors occur when fetching SmsUrl, or null if not set.

sms_methodstring required

Whether the request to SmsUrl is a GET or a POST.

sms_urlstring nullable required

The URL to request when an incoming SMS is received, or null if not set.

status_callbackstring nullable required

The URL to request to pass status updates to, or null if not set.

status_callback_methodstring required

Whether the request to StatusCallback is a GET or a POST.

trunk_sidstring nullable required

The unique identifier for the Trunk associated with this phone number. Always null.

uristring required

The URI for this number.

verification_statusstring

The verification status for toll-free numbers. Only present for toll-free numbers.

voice_application_sidstring nullable required

The unique identifier for the application associated with call handling on this phone number, or null if not set.

voice_caller_id_lookupboolean nullable required

Whether or not to look up a caller's name in the database. Always null.

voice_fallback_methodstring required

Whether the request to VoiceFallbackUrl is a GET or a POST.

voice_fallback_urlstring nullable required

The URL to request if errors occur when fetching Url, or null if not set.

voice_methodstring required

Whether the request to Url is a GET or a POST.

voice_urlstring nullable required

The URL to request when an incoming call is received, or null if not set.

Example response

{
  "api_version": "2010-04-01",
  "capabilities": {
    "voice": true,
    "sms": true,
    "mms": true,
    "fax": true
  },
  "country_code": "US",
  "date_created": "Tue, 25 Sept 2018 23:00:00 +0000",
  "date_updated": "Wed, 26 Sept 2018 22:00:00 +0000",
  "emergency_status": "Inactive",
  "friendly_name": "(310) 338-6745",
  "phone_number": "+13103386745",
  "sid": "b3877c40-da60-4998-90ad-b792e98472pn",
  "sms_fallback_method": "POST",
  "sms_method": "POST",
  "status_callback_method": "POST",
  "uri": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472ac/IncomingPhoneNumbers/b3877c40-da60-4998-90ad-b792e98472pn.json",
  "verification_status": "Unverified",
  "voice_fallback_method": "POST",
  "voice_method": "POST"
}

Changes