How to Manage a Messaging Service Sender Pool – Twilio Support

Objective

Messaging Services is a free Twilio feature designed to make it easier to send messages at-scale, as well as across multiple countries. In short, a Messaging Service is a container for multiple Twilio message senders, with additional message sending intelligence features. If you want to learn how to set up a Messaging Service, please check out Getting started with Messaging Services for a full walkthrough.

If you created a Messaging Service already, for example as part of A2P 10DLC onboarding, and you need to add numbers, read on.

Product

Programmable Messaging

Procedure

How do I add numbers to a Messaging Service?

You can add your Twilio phone numbers to a Messaging Service on your account via the Console or API.

Adding numbers to a Messaging Service using Console

In Console, navigate to your list of Messaging Services, then click on the one you want to add numbers to. On the left-hand side, click the “Sender Pool” link for your Messaging Service, then click the “Add Senders” button on the right side of the page. If you want to add Twilio phone numbers, this option will be pre-selected in the dialog that appears. Click Continue.

On the following page, you can either select your Twilio phone numbers from a list, or use the “Bulk-add phone numbers” option to input a list of numbers on your account that you wish to add to the Messaging Service.

Adding numbers to a Messaging Service using the API

You can add senders programmatically via the Phone Numbers, Short Codes, and Alpha Sender IDs subresources on the Messaging Services API.

How do I remove numbers from a Messaging Service?

Similar to how you can add your Twilio phone numbers to a Messaging Service on your account using one of the above options, you can also remove numbers via the Console or API.

Remove numbers from a Messaging Service using Console

In Console, navigate to your list of Messaging Services, then click on the one you want to remove numbers from. On the left-hand side, click the “Sender Pool” link for your Messaging Service, and here you will be presented with a list of all phone numbers currently in that specific Messaging Service.

To remove a single number, you can click the "Remove" button under the "Actions" column on the right side of that page.
To remove multiple numbers at once, you can select the checkbox next to each phone number, then click on the "Actions" dropdown at the top. From there, you'll choose the "Remove Selected Numbers" option, and click "Delete" in the popup window to complete the process.

Remove numbers from a Messaging Service using the API

You can remove senders from a Messaging Service's sender pool programmatically via the Phone Numbers, Short Codes, and Alpha Sender IDs subresources on the Messaging Services API.

How do I move numbers between Messaging Services?

Move numbers between Messaging Services using Console

To move phone numbers to a new Messaging Service in the Twilio Console, you can simply follow the "Adding numbers to a Messaging Service using Console" instructions above. During that process, if the phone number is found in an existing Messaging Service, you'll receive a warning prompt noting these details and will need to click "Confirm" to complete the move.

Move numbers between Messaging Services using the API

If you wish to move phone numbers between Messaging Services using the API, the best way to do this is to remove the numbers from the original Messaging Service first, wait at least 10-15 seconds (to allow for all async removal processes to complete), then add those senders to the new Messaging Service. The API remove and add instructions linked in the sections above should be used to complete this process.