The Hosted Phone Numbers API is currently in development and not intended for use by new customers. This documentation exists to support customers who are already using the API. A new version of this API will be released as a generally available (GA) product in the near future. New customers should wait for the Hosted Phone Numbers GA release.
An Authorization Document is a resource representing a legally binding document between Twilio and a customer to Authorize Twilio to run messaging traffic on a given set of Phone Numbers.
Hosted Number Orders can be assigned to an Authorization Document detailing which Address a Hosted Number Order is activated with. Once the Authorization Document has been signed, the Hosted Number Orders will then be registered to Twilio for routing capability.
Status of an instance resource. It can hold one of the values: 1. opened 2. signing, 3. signed LOA, 4. canceled, 5. failed. See the section entitled Status Values for more information on each of these statuses.
Document has been sent out to the Email for signature and is immutable.
signed
Document has been signed by the Email recipient and is immutable.
canceled
Document has been canceled by the Email recipient and is immutable.
failed
Document has failed with an error and is immutable.
Create an AuthorizationDocument resource
POST https://preview.twilio.com/HostedNumbers/AuthorizationDocuments
Create an Authorization Document for authorizing the hosting of phone numbers' capability on Twilio's platform.
The resource is explicit and all Hosted Number Orders added upon creation are the entire list of numbers that are assigned to the Authorization Document. Once the POST to create a new Authorization Document has been created, the LOA will immediately be sent out for signature.
Status of an instance resource. It can hold one of the values: 1. opened 2. signing, 3. signed LOA, 4. canceled, 5. failed. See the section entitled Status Values for more information on each of these statuses.
POST https://preview.twilio.com/HostedNumbers/AuthorizationDocuments/{Sid}
Requests to update a single, existing Authorization Documents instance resource's properties and returns the updated resource representation if successful.
(warning)
Warning
Authorization Documents can only be updated when in opened status. To update the Authorization Document, update the Status to opened.
Status of an instance resource. It can hold one of the values: 1. opened 2. signing, 3. signed LOA, 4. canceled, 5. failed. See the section entitled Status Values for more information on each of these statuses.