Proxy Overview Graphic


How it Works

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

The Proxy REST API allows you to create:

Additionally, you can add phone numbers with Voice or SMS capabilities to a phone number pool.


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 Auth Token and API Secret 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.

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.

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