---
title: "Import number"
method: POST
path: "/v1/projects/{projectId}/importedNumbers"
tags: ["Imported Numbers"]
---

# Import number

`POST /v1/projects/{projectId}/importedNumbers`

You can use the Import Numbers API to import a non-Sinch number that you want to enable for SMS with Sinch as the Direct Connectivity Aggregator (DCA) without porting (or even partially porting) the number.

Note: Customers who are importing numbers (i.e. want to use their own NNID) will need to complete the NNID provisioning process to support proper message routing with the carriers. To learn more, refer to the article [How can you provision a Network Number ID (NNID)?](https://community.sinch.com/t5/10DLC/How-can-you-provision-a-Network-Number-ID-NNID/ta-p/7040)

## Path parameters

- `projectId` string, required

## Request body

- CreateImportedNumberRequest
  - `phoneNumber` string — The phone number in e.164 format with leading +.
  - `projectId` string — The ID of the project resource. You can find your project ID on dashboard.sinch.com.
  - `regionCode` string — ISO 3166-1 alpha-2 country code of the phone number. Example US, UK or SE.
  - `displayName` string — User supplied name for the phone number.
  - `smsConfiguration` SmsConfiguration — Configuration for SMS
    - `servicePlanId` string — The current SMS configuration for this number. The `servicePlanId`` can be found when logging into dashboard.sinch.com in the SMS>APIs section.
    - `scheduledProvisioning` ScheduledProvisioning — Ongoing Provisioning for SMS service
      - `servicePlanId` string — Service plan of the scheduled provisioning task.
      - `status` integer — Status of the pending change.
      - `lastUpdatedTime` string, date-time — Timestamp when the status was last updated.
      - `campaignId` string — The campaign of the scheduled provisioning task.
      - `errorCodes` integer[] — A list of error codes, if applicable, for the scheduled provisioning task.
    - `campaignId` string — The current campaign ID assigned to this number.
    - `migrateToSinchTmo` boolean — Displays if a number is assigned to another aggregator in T-Mobile's platform, and requires migration from previous aggregator to Sinch.
  - `callbackUrl` string — The client's callback URL to be called upon finishing the number import.

## Response `200`

OK

- ImportedNumber
  - `phoneNumber` string — The phone number in e.164 format with leading +.
  - `projectId` string — The ID of the project resource. You can find your project ID on dashboard.sinch.com.
  - `regionCode` string — ISO 3166-1 alpha-2 country code of the phone number. Example US, UK or SE.
  - `displayName` string — User supplied name for the phone number.
  - `smsConfiguration` SmsConfiguration — Configuration for SMS
    - `servicePlanId` string — The current SMS configuration for this number. The `servicePlanId`` can be found when logging into dashboard.sinch.com in the SMS>APIs section.
    - `scheduledProvisioning` ScheduledProvisioning — Ongoing Provisioning for SMS service
      - `servicePlanId` string — Service plan of the scheduled provisioning task.
      - `status` integer — Status of the pending change.
      - `lastUpdatedTime` string, date-time — Timestamp when the status was last updated.
      - `campaignId` string — The campaign of the scheduled provisioning task.
      - `errorCodes` integer[] — A list of error codes, if applicable, for the scheduled provisioning task.
    - `campaignId` string — The current campaign ID assigned to this number.
    - `migrateToSinchTmo` boolean — Displays if a number is assigned to another aggregator in T-Mobile's platform, and requires migration from previous aggregator to Sinch.
  - `callbackUrl` string — The client's callback URL to be called upon finishing the number import.

## Other responses

- `400` — INVALID_ARGUMENT: If the importedNumber.phoneNumber, importedNumber.smsConfiguration.servicePlanId is not valid.
- `409` — The imported number already exists.
- `500` — INTERNAL: Internal server error. Typically, a server bug.

---

[API](https://skmtc.net/sinch/apis/imported-numbers-and-hosting-orders.md) · [All operations](https://skmtc.net/sinch/apis/imported-numbers-and-hosting-orders/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinch/imported-numbers-and-hosting-orders/revisions/c3d50cf4681d/schema)