---
title: "Import a Phone Number"
method: POST
path: "/Accounts/{AccountSid}/ImportedPhoneNumbers"
tags: ["Imported Phone Numbers"]
---

# Import a Phone Number

`POST /Accounts/{AccountSid}/ImportedPhoneNumbers`

Import a phone number hosted elsewhere into your SignalWire Space.

**Note:** This is a **Partner API**. To enable it on your SignalWire Space, contact 
[Sales](https://signalwire.com/company/contact?utm_campaign=devex_sent_em).

#### Permissions
The API token must include the following scopes: _Numbers_.

## Path parameters

- `AccountSid` string, uuid, required

## Request body

- ImportPhoneNumberRequest — Request body for importing a phone number.
  - `number` string, required — The phone number to import in E.164 format. Number must be between 5 and 30 characters with no special characters besides a leading `+`.
  - `number_type` 'longcode' | 'tollfree', required — The type of phone number being imported.
  - `capabilities` PhoneNumberCapability[] — The capabilities to enable for this phone number. Can include any combination of SMS, Voice, Fax, and MMS. If not provided, defaults to all capabilities (SMS, Voice, Fax, and MMS). Cannot be an empty array.

## Response `201`

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

- IncomingPhoneNumber — Incoming phone number model.
  - `account_sid` string, uuid — The unique identifier for the account that is associated with this phone number.
  - `address_requirements` 'none' | 'any' | 'local' | 'foreign' — Address requirements.
  - `address_sid` string — The unique identifier for the address associated with this phone number.
  - `api_version` string — The version of the SignalWire API.
  - `beta` boolean — New numbers on SignalWire are marked as beta.
  - `capabilities` IncomingPhoneNumberCapabilities — Phone number capabilities.
    - `Voice` boolean — Whether or not voice is enabled.
    - `SMS` boolean — Whether or not SMS is enabled.
    - `MMS` boolean — Whether or not MMS is enabled.
    - `Fax` boolean — Whether or not fax is enabled.
  - `date_created` string — The date, in RFC 2822 format, this phone number was created.
  - `date_updated` string — The date, in RFC 2822 format, this phone number was updated.
  - `emergency_address_sid` string, nullable — The unique identifier of the address associated with E911 for this phone number.
  - `emergency_status` 'active' | 'inactive' — Emergency status.
  - `friendly_name` string — A formatted version of the number.
  - `identity_sid` string — The unique identifier for the identity associated with this phone number.
  - `origin` 'signalwire' | 'hosted' — Phone number origin.
  - `phone_number` string — The incoming number in E.164 format.
  - `sid` string — The unique identifier for this phone number.
  - `sms_application_sid` string, nullable — The unique identifier for the application associated with SMS handling on this phone number.
  - `sms_fallback_method` string — Whether the request to `SmsFallbackUrl` is a `GET` or a `POST`. Default is `POST`.
  - `sms_fallback_url` string, nullable — The URL to request if errors occur when fetching SmsUrl.
  - `sms_method` string — Whether the request to SmsUrl is a `GET` or a `POST`. Default is `POST`.
  - `sms_url` string, nullable — The URL to request when an incoming SMS is received.
  - `status_callback` string — The URL to request to pass status updates to.
  - `status_callback_method` string — Whether the request to StatusCallback is a `GET` or a `POST`. Default is `POST`.
  - `trunk_sid` string — The unique identifier for the Trunk associated with this phone number.
  - `uri` string — The URI for this number.
  - `voice_application_sid` string, nullable — The unique identifier for the application associated with call handling on this phone number.
  - `voice_caller_id_lookup` boolean — Whether or not to look up a caller's name in the database.
  - `voice_fallback_method` string — Whether the request to VoiceFallbackUrl is a `GET` or a `POST`. Default is `POST`.
  - `voice_fallback_url` string — The URL to request if errors occur when fetching `Url`.
  - `voice_method` string — Whether the request to Url is a `GET` or a `POST`. Default is `POST`.
  - `voice_url` string — The URL to request when an incoming call is received.

## Other responses

- `400` — 400 Bad Request response.
- `401` — 401 Unauthorized response.
- `422` — 422 Unprocessable Entity response.

## Changes

- **2026-01-15** `686ef84c2abc` — 5 breaking
  - the response property `emergency_address_sid` became nullable for the status `201`
  - the response property `sms_application_sid` became nullable for the status `201`
  - the response property `sms_fallback_url` became nullable for the status `201`
  - the response property `sms_url` became nullable for the status `201`
  - …1 more
- **2026-01-15** `3c88f14db21e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/signalwire/apis/compatibility-api/changes/Accounts/:AccountSid/ImportedPhoneNumbers/post.md)

---

[API](https://skmtc.dev/signalwire/apis/compatibility-api.md) · [All operations](https://skmtc.dev/signalwire/apis/compatibility-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/signalwire/compatibility-api/revisions/686ef84c2abc/schema)