---
title: "Text enable numbers in hosting orders"
method: POST
path: "/v1/projects/{projectId}/hostingOrders:textEnableNumbers"
tags: ["Hosting Orders"]
---

# Text enable numbers in hosting orders

`POST /v1/projects/{projectId}/hostingOrders:textEnableNumbers`

Text enable numbers associated with hosting orders of a specific project.

## Path parameters

- `projectId` string, required

## Request body

- TextEnableNumbersRequest — A request to text enable the numbers in a hosting order.
  - `projectId` string — The ID of the project to which the hosting order is associated.
  - `displayName` string — The optional display name of the hosting order.
  - `regionCode` string, required — The region code for the hosting order.
  - `numbers` string[], required — An array of all the phone numbers associated with the hosting order.
  - `nnid` string — Defaults to either Sinch NNID or what was originally configured on the customer account. Sinch encourages customers to use the Sinch NNID, but if you want to use another NNID, please contact your account manager.
  - `servicePlanId` string, required — The ID of the service plan to which the hosting order is associated.
  - `campaignId` string — The ID of the campaign to which the hosting order is associated.
  - `directLoaInfo` DirectLoaInfo — Letter of Authorization for direct Sinch customers.
    - `authorisedPerson` AuthorizedPerson, required — The person authorized and responsible for the hosting order.
      - `firstName` string, required — The first name of the authorized person.
      - `lastName` string, required — The last name of the authorized person.
      - `email` string, required — The email address of the authorized person.
    - `address` Address, required — The address of the business.
      - `buildingNumber` string, required — The building number of the address.
      - `street` string, required — The street name of the address.
      - `city` string, required — The city name of the address.
      - `state` string, required — The state name of the address.
      - `postalCode` string, required — The postal code of the address.
      - `country` string, required — The country of the address.
    - `currentVoiceCarrier` string, required — The current carrier you are using for voice services for the number you want to host on Sinch.
  - `resellerLoaInfo` ResellerLoaInfo — Letter of Authorization for resellers.
    - `businessName` string, required — The name of the business.
    - `authorisedPerson` AuthorizedPerson, required — The person authorized and responsible for the hosting order.
      - `firstName` string, required — The first name of the authorized person.
      - `lastName` string, required — The last name of the authorized person.
      - `email` string, required — The email address of the authorized person.
    - `address` Address, required — The address of the business.
      - `buildingNumber` string, required — The building number of the address.
      - `street` string, required — The street name of the address.
      - `city` string, required — The city name of the address.
      - `state` string, required — The state name of the address.
      - `postalCode` string, required — The postal code of the address.
      - `country` string, required — The country of the address.
    - `currentVoiceCarrier` string, required — The current carrier you are using for voice services for the number you want to host on Sinch.
  - `blanketLoaInfo` BlanketLoaInfo — You can set up a blanket Letter of Authorization (LoA) that will allow you to import numbers to your account without having to sign an LoA each time you submit a request. To set up a blanket LoA, email your account manager. Once the LoA has been approved, you can use this `blanketLoaInfo` object in your requests. The `blanketLoaInfo` object should be sent as an empty object.
  - `scheduledOsrUpdateTime` string, date-time — The scheduled time for OSR to be updated.
  - `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 for text enablement updates.

## Response `200`

A successful response with a hosting order, or an error

- HostingOrder
  - `projectId` string — The project ID to which the hosting order is associated.
  - `hostingOrderId` string — The unique ID of the hosting order.
  - `displayName` string — The friendly name of the hosting order.
  - `regionCode` string — The region code of the hosting order. Number hosting is only available for the US and Canada, so you must enter either "US" or "CA".
  - `state` 'HOSTING_ORDER_STATE_UNSPECIFIED' | 'DRAFT' | 'SUBMITTED' | 'WAITING_FOR_LOA_SIGNATURE' | 'IN_PROGRESS' | 'COMPLETED' | 'REJECTED' — The state of the hosting order.
  - `type` 'HOSTING_ORDER_TYPE_UNSPECIFIED' | 'IMPORT' | 'TYPE_TEXT_ENABLE' — The hosting order type.
  - `createdTime` string, date-time — Timestamp when the hosting order was created
  - `updatedTime` string, date-time — Timestamp when the hosting order was last updated
  - `scheduledOsrUpdateTime` string, date-time — Timestamp when the OSR update will be done
  - `servicePlanId` string — The service plan to which the hosting order is associated.
  - `campaignId` string — The campaign to which the hosting order is associated.
  - `migrateToSinchTmo` boolean — Displays if a number is assigned to another aggregator in T-Mobile's platform, and requires migration from previous aggregator to Sinch.
  - `textEnableInfo` TextEnableInfo
    - `businessName` string — The name of the business.
    - `authorisedPerson` AuthorizedPerson — The person authorized and responsible for the hosting order.
      - `firstName` string, required — The first name of the authorized person.
      - `lastName` string, required — The last name of the authorized person.
      - `email` string, required — The email address of the authorized person.
    - `address` Address — The address of the business.
      - `buildingNumber` string, required — The building number of the address.
      - `street` string, required — The street name of the address.
      - `city` string, required — The city name of the address.
      - `state` string, required — The state name of the address.
      - `postalCode` string, required — The postal code of the address.
      - `country` string, required — The country of the address.
    - `serviceProvider` string
    - `currentVoiceCarrier` string — The current carrier you are using for voice services for the number you want to host on Sinch.
    - `nnid` string — The Net Number ID for the number you want to host on Sinch.
    - `loaType` 'Direct' | 'Reseller', enum — The type of the letter of authorization.
  - `callbackUrl` string — The client's callback URL to be called upon finishing the number import.

## Other responses

- `400` — Status returned if any of the projectId, displayName, regionCode, numbers, nnid, servicePlanId or campaignId parameters are not valid
- `404` — The imported number, project, hosting order, qualified number or phone number could not be found
- `409` — The imported number already exists and cannot be created
- `500` — 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)
