Rate this page:

The Proxy API Overview

Public Beta

Twilio's Proxy API is currently available as a Public Beta product. Some features are not yet implemented and others may be changed before the product is declared as Generally Available.

Public Beta products are not covered by a Twilio SLA.

How it works

Twilio Proxy is exposed as a REST API that allows you to create masked / anonymized text and voice conversations between users.

Proxy Overview Graphic

The Proxy REST API allows you to create and manage:

Additionally, you can add phone numbers with Voice or SMS capabilities and SMS-capable short codes to a phone number pool.

REST API resources diagram

Proxy REST API Diagram

API base URL

All URLs in the reference documentation use the following base URL:

All requests to the Proxy REST API are served over HTTPS. Unencrypted HTTP is not supported.


HTTP requests to the REST API are protected with HTTP Basic Authentication like other Twilio REST APIs. To learn more about how Twilio handles authentication, please refer to our security documentation.

To authenticate, you will need your Account SID and Auth Token from the Twilio Console:

Twilio Account Summary section of the console

You will use your Twilio Account SID as the username and your Auth Token as the password for HTTP Basic authentication.

Helper libraries

If you use one of our helper libraries for C#, Java, Node.js, PHP, Python, or Ruby; you needn't worry about the URL for the API or how to do HTTP Basic authentication. The helper libraries take care of it for you.

Getting started

Refer to our quickstart guide for a step by step introduction to Proxy, or browse the Proxy resources listed in the left-hand navigation for API Reference material.

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 Community Forums or browsing the Twilio tag on Stack Overflow.


        Thank you for your feedback!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

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

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more