---
title: "Create an AuthorizationDocument for authorizing the hosting of phone number capabilities on Twilio's platform."
method: POST
path: "/v2/HostedNumber/AuthorizationDocuments"
tags: ["NumbersV2AuthorizationDocument"]
---

# Create an AuthorizationDocument for authorizing the hosting of phone number capabilities on Twilio's platform.

`POST /v2/HostedNumber/AuthorizationDocuments`

Create an AuthorizationDocument for authorizing the hosting of phone number capabilities on Twilio's platform.

## Response `201`

Created

- NumbersV2AuthorizationDocument
  - `sid` string, nullable — A 34 character string that uniquely identifies this AuthorizationDocument.
  - `address_sid` string, nullable — A 34 character string that uniquely identifies the Address resource that is associated with this AuthorizationDocument.
  - `status` 'opened' | 'signing' | 'signed' | 'canceled' | 'failed' — 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](https://www.twilio.com/docs/phone-numbers/hosted-numbers/hosted-numbers-api/authorization-document-resource#status-values) for more information on each of these statuses.
  - `email` string, nullable — Email that this AuthorizationDocument will be sent to for signing.
  - `cc_emails` string[], nullable — Email recipients who will be informed when an Authorization Document has been sent and signed.
  - `date_created` string, date-time, nullable — The date this resource was created, given as [GMT RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format.
  - `date_updated` string, date-time, nullable — The date that this resource was updated, given as [GMT RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format.
  - `url` string, uri, nullable
  - `links` object, nullable

---

[API](https://skmtc.net/twilio/apis/numbers-v2.md) · [All operations](https://skmtc.net/twilio/apis/numbers-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/numbers-v2/versions/4e238625c212/schema)