Imported Phone Numbers

Import a Phone Number

Changed on

Registers a phone number you already own so it can route communications through the project while remaining externally hosted. Use Create an Incoming Phone Number to purchase from SignalWire inventory, or SignalWire REST Import phone number for a JSON request.

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

Request

  • Base URL
    https://YOUR_SPACE.signalwire.com/api/laml/2010-04-01
  • URL
    https://YOUR_SPACE.signalwire.com/api/laml/2010-04-01/Accounts/{AccountSid}/ImportedPhoneNumbers
  • Auth
    HTTP basic

Path parameters

AccountSidstring uuid required

Universal Unique Identifier.

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

Request body application/x-www-form-urlencoded

numberstring required

The phone number to import in E.164 format. Must start with + followed by 5-30 digits.

number_type'longcode' | 'tollfree' required

The type of phone number being imported.

capabilitiesPhoneNumberCapability[]

The capabilities to enable for this phone number. If not provided, defaults to all capabilities (sms, voice, fax, mms). If provided, must include at least one capability.

Example request

{
  "number": "+49152234333323",
  "capabilities": [
    "sms",
    "voice"
  ]
}

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

Changes

  • 2916d5e3072eRevision changes
    • breaking

      the response's property type changed from string to no type, and format from uuid to no format for status

    • breaking

      the response's property type changed from string to no type, and format from uuid to no format for status

    • info

      added to the response property allOf list for the response status

    • info

      added to the response property allOf list for the response status

  • 5344c0c93a4cRevision changes
    • breaking

      added 'unevaluatedProperties' constraint to the request body

    • info

      added 'unevaluatedProperties' constraint to the response body for the status

    • info

      added 'unevaluatedProperties' constraint to the response body for the status

    • info

      added 'unevaluatedProperties' constraint to the response body for the status

    • info

      added 'unevaluatedProperties' constraint to the response body for the status

    • info

      added 'unevaluatedProperties' constraint to the //// response property for the status