latestOpenAPI 3.0.3MIT2026-08-102357127.0 KB

c3d50cf4681d

Imported Numbers

Update imported number

Update an imported phone number. You can perform the following updates:

Update the name that displays for a customer by modifying the displayName parameter.
Unlink the number from an SMS service or campaign by updating the smsConfiguration configuration object. To unlink a number, submit the request with an empty string (””) in the service plan ID or campaign ID fields.
Before linking a number to a new service or campaign, it must be unlinked from any existing service or campaign. Then, link the number to a new SMS service or campaign by updating the service plan ID or campaign ID with the new desired value.

patch/v1/projects/{projectId}/importedNumbers/{phoneNumber}

Path parameters

projectIdstring required

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

Found on your Sinch Customer Dashboard. Settings > Projects.

phoneNumberstring required

Example:+12025550134

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

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