latestOpenAPI 3.0.3MIT2026-08-102357127.0 KB

c3d50cf4681d

Imported Numbers

Import number

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)?

post/v1/projects/{projectId}/importedNumbers

Path parameters

projectIdstring required

Example:d1923022-5199-4bb3-a513-c47b3a656bc5

Found on your Sinch Customer Dashboard. Settings > Projects.

Request body

phoneNumberstring

The phone number in e.164 format with leading +.

projectIdstring

The ID of the project resource. You can find your project ID on dashboard.sinch.com.

regionCodestring

ISO 3166-1 alpha-2 country code of the phone number. Example US, UK or SE.

displayNamestring

User supplied name for the phone number.

callbackUrlstring

The client's callback URL to be called upon finishing the number import.

Example request

{
  "phoneNumber": "+12025550134",
  "projectId": "YOUR_project_id",
  "regionCode": "US",
  "displayName": "MyPhoneNumber",
  "smsConfiguration": {
    "servicePlanId": "YOUR_service_plan_id",
    "scheduledProvisioning": {
      "servicePlanId": "YOUR_service_plan_id",
      "campaignId": "YOUR_campaign_id"
    },
    "campaignId": "YOUR_campaign_id"
  },
  "callbackUrl": "https://www.your-callback-server.com/callback"
}

Response