Menu

Expand
Rate this page:

Authorization Document Resource

Hosted Numbers API is currently in private Developer Preview

An Authorization Document is a resource representing a legally binding document between Twilio and a customer to Authorize Twilio to run SMS 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.

AuthorizationDocument properties

Resource Properties in REST API format
sid
sid<PX> Not PII

A 34 character string that uniquely identifies this AuthorizationDocument.

address_sid
sid<AD> Not PII

A 34 character string that uniquely identifies the Address resource that is associated with this AuthorizationDocument.

status
enum:status Not PII

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.

email

Email that this AuthorizationDocument will be sent to for signing.

cc_emails
string[] PII MTL: 30 DAYS

Email recipients who will be informed when an Authorization Document has been sent and signed.

date_created
date_time<iso8601> Not PII

The date this resource was created, given as GMT RFC 2822 format.

date_updated
date_time<iso8601> Not PII

The date that this resource was updated, given as GMT RFC 2822 format.

url
url Not PII

links
uri_map Not PII

Status Values

Status Description
opened Document is open and mutable.
signing 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.

Parameters
Parameters in REST API format
hosted_number_order_sids
Required
post string[] Not PII

A list of HostedNumberOrder sids that this AuthorizationDocument will authorize for hosting phone number capabilities on Twilio's platform.

address_sid
Required
post sid<AD> Not PII

A 34 character string that uniquely identifies the Address resource that is associated with this AuthorizationDocument.

email
Required
post string PII MTL: 30 DAYS

Email that this AuthorizationDocument will be sent to for signing.

contact_title
Required
post string Not PII

The title of the person authorized to sign the Authorization Document for this phone number.

contact_phone_number
Required
post string PII MTL: 30 DAYS

The contact phone number of the person authorized to sign the Authorization Document.

cc_emails
Optional
post string[] PII MTL: 30 DAYS

Email recipients who will be informed when an Authorization Document has been sent and signed.

Example 1
        
        
        

        Create Authorization Document

        Fetch an AuthorizationDocument resource

        get
        https://preview.twilio.com/HostedNumbers/AuthorizationDocuments/{Sid}
        Parameters
        Parameters in REST API format
        sid
        Path
        get sid<PX> Not PII

        A 34 character string that uniquely identifies this AuthorizationDocument.

        Example 1
              
              
              

              Fetch Authorization Document

              Read multiple AuthorizationDocument resources

              get
              https://preview.twilio.com/HostedNumbers/AuthorizationDocuments
              Parameters
              Parameters in REST API format
              email
              Optional
              get string PII MTL: 30 DAYS

              Email that this AuthorizationDocument will be sent to for signing.

              status
              Optional
              get enum:status Not PII

              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.

              Example 1
                    
                    
                    

                    Read Authorization Document

                    Update an AuthorizationDocument resource

                    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.

                    Authorization Documents can only be updated when in opened status. To update the Authorization Document, update the Status to opened.

                    Parameters
                    Parameters in REST API format
                    sid
                    Path
                    post sid<PX> Not PII

                    hosted_number_order_sids
                    Optional
                    post string[] Not PII

                    A list of HostedNumberOrder sids that this AuthorizationDocument will authorize for hosting phone number capabilities on Twilio's platform.

                    address_sid
                    Optional
                    post sid<AD> Not PII

                    A 34 character string that uniquely identifies the Address resource that is associated with this AuthorizationDocument.

                    email
                    Optional
                    post string PII MTL: 30 DAYS

                    Email that this AuthorizationDocument will be sent to for signing.

                    cc_emails
                    Optional
                    post string[] PII MTL: 30 DAYS

                    Email recipients who will be informed when an Authorization Document has been sent and signed

                    status
                    Optional
                    post enum:status Not PII

                    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.

                    contact_title
                    Optional
                    post string Not PII

                    The title of the person authorized to sign the Authorization Document for this phone number.

                    contact_phone_number
                    Optional
                    post string PII MTL: 30 DAYS

                    The contact phone number of the person authorized to sign the Authorization Document.

                    Example 1
                          
                          
                          

                          Update Authorization Document

                          Rate this page:

                          Need some help?

                          We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

                                
                                
                                

                                Thank you for your feedback!

                                Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

                                Sending your feedback...
                                🎉 Thank you for your feedback!
                                Something went wrong. Please try again.

                                Thanks for your feedback!

                                thanks-feedback-gif