Sign in

v36

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-1279125449.6 KB
Imported Phone Numbers

Import a Phone Number

Import a phone number you already own to your SignalWire Space to use with SignalWire APIs.

Note: This is a Partner API. To enable it on your SignalWire Space, contact Sales.

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}/ImportedPhoneNumbers

Path parameters

AccountSidstring uuid required

Universal Unique Identifier.

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

Response

The request has succeeded and a new resource has been created as a result.

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"
}