Reserved Phone Numbers

(error)

Proxy Public Beta is not available to new customers

Proxy Public Beta is currently closed for new customers. Please consider using Twilio Conversations and Programmable Voice directly if you are building your masking application.

Note that this does not have any impact on Twilio Flex customers.

(warning)

Public Beta for customers already using Proxy

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.

When you set up a Proxy Service, you add one or more Proxy Numbers (Twilio Phone Numbers) to its pool. When you then add Participants to Proxy Sessions, Proxy selects numbers from this pool as the Participant's Proxy Identifier.

You can read more about how Proxy selects which Phone Number to use in a certain Session in Understanding Phone Number Management, but essentially, Proxy will assign phone numbers from the Proxy Numbers Pool to Participants in order to enable masked communication.

There are some situations where you might want a number in your pool to be set aside and not randomly assigned to Participants. For these situations, Proxy allows you to mark a number in your pool as Reserved.

For example, you may decide to remove a Number from your pool to move to another Service, or to use in a non-Proxy use case. In order to do this safely, though, you need to wait until no active Participants are using the number. By marking the Number as Reserved, you will allow it to "drain" until it becomes safe to remove from the pool.
Another common scenario for which Reserved numbers are useful is that in which you wish to associate a Proxy Number with only one real-world Phone Number (for instance, if you wanted to publish a number on a business card or advertisement) while still using Proxy's number masking functionality.

When adding a Phone Number to the Proxy Number Pool, you have the ability to mark a Phone Number as a Reserved Phone Number with the is_reserved option. You can also do this through the console by marking your proxy phone number as a Reserved Number.