# Text enable numbers in hosting orders

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

Endpoint: POST /v1/projects/{projectId}/hostingOrders:textEnableNumbers
Version: 1.0
Security: Basic, OAuth2.0

## Path parameters:

  - `projectId` (string, required)
    Found on your Sinch Customer Dashboard. Settings > Projects.
    Example: "d1923022-5199-4bb3-a513-c47b3a656bc5"

## Request fields (application/json):

  - `regionCode` (string, required)
    The region code for the hosting order.
    Example: "US"

  - `numbers` (array, required)
    An array of all the phone numbers associated with the hosting order.
    Example: ["+12025550134"]

  - `servicePlanId` (string, required)
    The ID of the service plan to which the hosting order is associated.
    Example: "YOUR_service_plan_id"

  - `projectId` (string)
    The ID of the project to which the hosting order is associated.
    Example: "YOUR_project_id"

  - `displayName` (string)
    The optional display name of the hosting order.
    Example: "MyHostingOrder"

  - `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.

  - `campaignId` (string)
    The ID of the campaign to which the hosting order is associated.
    Example: "YOUR_campaign_id"

  - `directLoaInfo` (object)
    Letter of Authorization for direct Sinch customers.

  - `directLoaInfo.authorisedPerson` (object, required)
    The person authorized and responsible for the hosting order.

  - `directLoaInfo.authorisedPerson.firstName` (string, required)
    The first name of the authorized person.
    Example: "John"

  - `directLoaInfo.authorisedPerson.lastName` (string, required)
    The last name of the authorized person.
    Example: "Doe"

  - `directLoaInfo.authorisedPerson.email` (string, required)
    The email address of the authorized person.
    Example: "john.doe@company.com"

  - `directLoaInfo.address` (object, required)
    The address of the business.

  - `directLoaInfo.address.buildingNumber` (string, required)
    The building number of the address.
    Example: "123"

  - `directLoaInfo.address.street` (string, required)
    The street name of the address.
    Example: "1st"

  - `directLoaInfo.address.city` (string, required)
    The city name of the address.
    Example: "New York"

  - `directLoaInfo.address.state` (string, required)
    The state name of the address.
    Example: "NY"

  - `directLoaInfo.address.postalCode` (string, required)
    The postal code of the address.
    Example: "00001"

  - `directLoaInfo.address.country` (string, required)
    The country of the address.
    Example: "USA"

  - `directLoaInfo.currentVoiceCarrier` (string, required)
    The current carrier you are using for voice services for the number you want to host on Sinch.
    Example: "TMO"

  - `resellerLoaInfo` (object)
    Letter of Authorization for resellers.

  - `resellerLoaInfo.businessName` (string, required)
    The name of the business.
    Example: "Acme, Inc."

  - `blanketLoaInfo` (object)
    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  object in your requests. The  object should be sent as an empty object.

  - `scheduledOsrUpdateTime` (string)
    The scheduled time for OSR to be updated.

  - `callbackUrl` (string)
    The client's callback URL to be called for text enablement updates.
    Example: "https://www.your-callback-server.com/callback"

## Response 200 fields (application/json):

  - `projectId` (string)
    The project ID to which the hosting order is associated.
    Example: "YOUR_project_id"

  - `hostingOrderId` (string)
    The unique ID of the hosting order.
    Example: "YOUR_hosting_order_id"

  - `displayName` (string)
    The friendly name of the hosting order.
    Example: "MyHostingOrder"

  - `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".
    Example: "US"

  - `state` (string)
    The state of the hosting order.
    Enum: "HOSTING_ORDER_STATE_UNSPECIFIED", "DRAFT", "SUBMITTED", "WAITING_FOR_LOA_SIGNATURE", "IN_PROGRESS", "COMPLETED", "REJECTED"

  - `type` (string)
    The hosting order type.
    Enum: "HOSTING_ORDER_TYPE_UNSPECIFIED", "IMPORT", "TYPE_TEXT_ENABLE"

  - `createdTime` (string)
    Timestamp when the hosting order was created

  - `updatedTime` (string)
    Timestamp when the hosting order was last updated

  - `scheduledOsrUpdateTime` (string)
    Timestamp when the OSR update will be done

  - `servicePlanId` (string)
    The service plan to which the hosting order is associated.
    Example: "YOUR_service_plan_id"

  - `campaignId` (string)
    The campaign to which the hosting order is associated.
    Example: "YOUR_campaign_id"

  - `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` (object)

  - `textEnableInfo.businessName` (string)
    The name of the business.
    Example: "Acme, Inc."

  - `textEnableInfo.authorisedPerson` (object)
    The person authorized and responsible for the hosting order.

  - `textEnableInfo.authorisedPerson.firstName` (string, required)
    The first name of the authorized person.
    Example: "John"

  - `textEnableInfo.authorisedPerson.lastName` (string, required)
    The last name of the authorized person.
    Example: "Doe"

  - `textEnableInfo.authorisedPerson.email` (string, required)
    The email address of the authorized person.
    Example: "john.doe@company.com"

  - `textEnableInfo.address` (object)
    The address of the business.

  - `textEnableInfo.address.buildingNumber` (string, required)
    The building number of the address.
    Example: "123"

  - `textEnableInfo.address.street` (string, required)
    The street name of the address.
    Example: "1st"

  - `textEnableInfo.address.city` (string, required)
    The city name of the address.
    Example: "New York"

  - `textEnableInfo.address.state` (string, required)
    The state name of the address.
    Example: "NY"

  - `textEnableInfo.address.postalCode` (string, required)
    The postal code of the address.
    Example: "00001"

  - `textEnableInfo.address.country` (string, required)
    The country of the address.
    Example: "USA"

  - `textEnableInfo.serviceProvider` (string)

  - `textEnableInfo.currentVoiceCarrier` (string)
    The current carrier you are using for voice services for the number you want to host on Sinch.
    Example: "TMO"

  - `textEnableInfo.nnid` (string)
    The Net Number ID for the number you want to host on Sinch.

  - `textEnableInfo.loaType` (string)
    The type of the letter of authorization.
    Enum: "Direct", "Reseller"

  - `callbackUrl` (string)
    The client's callback URL to be called upon finishing the number import.
    Example: "https://www.your-callback-server.com/callback"

## Response 400 fields (application/json):

  - `code` (string)
    The HTTP response code for the error.
    Example: "404"

  - `message` (string)
    The friendly message describing the reason for the error response.
    Example: "The imported number could not be found."

  - `status` (string)
    The HTTP response status for the error.
    Example: "NOT_FOUND"

## Response 404 fields (application/json):

  - `code` (string)
    The HTTP response code for the error.
    Example: "404"

  - `message` (string)
    The friendly message describing the reason for the error response.
    Example: "The imported number could not be found."

  - `status` (string)
    The HTTP response status for the error.
    Example: "NOT_FOUND"

## Response 409 fields (application/json):

  - `code` (string)
    The HTTP response code for the error.
    Example: "404"

  - `message` (string)
    The friendly message describing the reason for the error response.
    Example: "The imported number could not be found."

  - `status` (string)
    The HTTP response status for the error.
    Example: "NOT_FOUND"

## Response 500 fields (application/json):

  - `code` (string)
    The HTTP response code for the error.
    Example: "404"

  - `message` (string)
    The friendly message describing the reason for the error response.
    Example: "The imported number could not be found."

  - `status` (string)
    The HTTP response status for the error.
    Example: "NOT_FOUND"