Pooling

Pooling allows you to distribute messages across multiple sender numbers, ensuring reliable delivery even at high volumes. By creating a Sender Pool, you can group multiple senders (such as RCS, SMS, or WhatsApp) to increase throughput and enable automatic failover for failed messages.

Create a Sender Pool

If you need to manage multiple senders, create a Sender Pool. A Sender Pool can improve message throughput and let you combine different sender types, for example, RCS, SMS, and WhatsApp. If a message fails, Twilio automatically retries delivery through an alternative channel (failover).

Sample request:

curl -X POST "https://comms.twilio.com/preview/SenderPools" \
--header 'Content-Type: application/json' \
--data '
{
  "name": "Sales Leads - APAC",
  "tags": {
    "region": "APAC"
  }
}' \
-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

See the full Sender Pools API reference for more details on creating and managing Sender Pools.

Add a Sender to a Sender Pool

Now that you’ve created a Sender Pool, add the sender you want to your Pool.

curl -X POST "https://comms.twilio.com/preview/SenderPools/comms_senderpool_12345/Senders" \
--header 'Content-Type: application/json' \
--data '{
  "senderId": "comms_sender_01h9krwprkeee8fzqspvwy6nq8"
}' \
-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

You can then send a message using the Sender Pool as the sender.

curl -X POST "https://comms.twilio.com/preview/Messages" \
-H "Content-Type: application/json" \
-d '{
  "from": {
    "senderPoolId": "comms_senderpool_12345"
  },
  "to": [
    {
      "address": "+19143188062",
      "channel": "PHONE"
    }
  ],
  "content": {
    "text": "Now I'\''m just using some of my senders!"
  }
}' \
-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Benefits of pooling

Scalability: Distribute high-volume sends across multiple numbers
Reliability: Automatic failover to alternate senders or channels
Flexibility: Mix and match sender types (SMS, WhatsApp, RCS, etc.) in a single pool

Next steps

Learn more about configuring and managing your sender options in the Sender Pools guide.