Rate this page:

Reserved Phone Numbers

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 the number as a Reserved Number.

Proxy Reserved Phone Number in the Console

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