Rate this page:

Thanks for rating this page!

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

Proxy: One-to-one Masked Communications

Twilio Proxy simplifies the task of masking the communications between two parties (aka masked phone numbers or masked calling). Proxy automatically provides a number and associates two numbers together in order to forward messages and calls back and forth.

Proxy Overview Graphic

With Proxy, Twilio facilitates any use case that can benefit from a temporary conversation between two parties.

Not a developer? See the Proxy product page.

Get started with Proxy

Follow our quickstart for the fastest experience adding masked phone numbers for SMS and Voice communications.

Build your app

You've got an idea in mind that could employ ephemeral communications. Let us help you make it a reality.

These docs will help you turn that idea into production and show you all of the details you need to have a hit on your hands.

Usage guides

API reference

Privacy advisory

It is best practice, and also potentially required by law in certain jurisdictions, for you to have consent from your end users before using Proxy to manage communications between them. It is best practice to achieve consent from users that makes it clear that when using a service powered by Proxy they are not communicating directly with each other but that their communications are being proxied and recorded by you and your service provider (e.g. Twilio). You should respect your end user's choice to not receive messages/calls whether via Proxy or any other Twilio product. It is also important to make sure your database is up to date. This is particularly important for number-based communications like SMS because over time phone numbers may be reassigned to different individuals. If your database is out of date, you could inadvertently initiate communications to someone who did not consent but was reassigned a phone number that was previously subscribed to your service by another person. Check out the Twilio Marketplace for Add-ons from our partners that can help you keep your database up to date.

Twilio recommends that you consult with your legal counsel to make sure that you are complying with all applicable laws in connection with communications you transmit using Twilio.

Public Beta

Twilio Proxy is currently in public beta and is accessible to all Twilio accounts.

Getting Help

Have more questions about Proxy and masking the communications between two parties? Please reach out to our Sales team to discuss pricing or support for technical questions about Proxy.

Loading Code Sample...