---
title: "Create an Incoming Phone Number"
method: POST
path: "/Accounts/{AccountSid}/IncomingPhoneNumbers"
tags: ["Incoming Phone Numbers"]
---

# Create an Incoming Phone Number

`POST /Accounts/{AccountSid}/IncomingPhoneNumbers`

Create an Incoming Phone Number.

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

## Path parameters

- `AccountSid` string, uuid, required

## Response `200`

OK

- object
  - `account_sid` string, uuid — The unique identifier for the account that is associated with this phone number.
  - `address_requirements` 'none' | 'any' | 'local' | 'foreign' — Whether or not a registered address with SignalWire is required.
  - `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` object — Whether or not a number can receive calls and messages.
    - `Voice` boolean
    - `SMS` boolean
    - `MMS` boolean
    - `Fax` boolean
  - `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 — The unique identifier of the address associated with E911 for this phone number.
  - `emergency_status` 'active' | 'inactive' — Whether the phone route has an active E911 address associated.
  - `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' — The origin of the phone number. SignalWire numbers are denoted as `signalwire` while hosted numbers are denoted as `hosted`.
  - `phone_number` string — The incoming number in E.164 format.
  - `sid` string — The unique identifier for this phone number.
  - `sms_application_sid` string — The unique identifier for the application associated with SMS handling on this phone number. If `SmsApplicationSid` is present, the URLs on the application will be used and all other URLs will be ignored.
  - `sms_fallback_method` 'GET' | 'POST' — Whether the request to `SmsFallbackUrl` is a `GET` or a `POST`. Default is `POST`.
  - `sms_fallback_url` string — The URL to request if errors occur when fetching SmsUrl.
  - `sms_method` 'GET' | 'POST' — Whether the request to SmsUrl is a `GET` or a `POST`. Default is `POST`.
  - `sms_url` string — 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` 'GET' | 'POST' — 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 — The unique identifier for the application associated with call handling on this phone number. If `VoiceApplicationSid` is present, the URLs on the application will be used and all other URLs will be ignored.
  - `voice_caller_id_lookup` boolean — Whether or not to look up a caller's name in the database.
  - `voice_fallback_method` 'GET' | 'POST' — 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` 'GET' | 'POST' — 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.

---

[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/e1376ef9bfca/schema)