This is the API V2 documentation. To switch out of beta revert back to our API V1.

Open SidemenuDocs
Docs
Close Sidemenu
Choose:
Mission Control PortalcURLPythonRubyNodePHP
Mission Control PortalcURLPythonRubyNodePHP

Number Pool For Outbound Messaging Trafficnumber-pool-for-outbound-messaging-traffic

Number Pool distributes your outbound messaging traffic across multiple phone numbers to help you manage your messaging campaigns. The pool of numbers includes all long code and toll-free numbers assigned to your Messaging Profile. When you send a message, the “From” number is selected from the numbers in your Number Pool that aren’t currently being used to send a message.

Follow the instructions below to set up Number Pool on one of your Messaging Profiles. You will also need to associate at least one phone number with the Messaging Profile.

When sending messages, use the send endpoint for Number PoolAPI. You will need to omit the “From” field from the request and instead specify the Messaging Profile (via the messaging_profile_id parameter) with the number pool you'd like to utilize for sending your message.

Number Weightsnumber-weights

Long Code and Toll Free weight defines the ratio at which a number type will be selected when sending a message. For example, if Long Code weight is 5, and Toll Free weight is 1, then every five messages will be sent from a Long Code number in the number pool, and the sixth message will be sent from a Toll Free number. The sum of the weights for all number types does not necessarily need to add to 100. Weight must be a non-negative number, and when equal to zero it will remove the number type from the pool.

Skipping Unhealthy Numbersskipping-unhealthy-numbers

If this feature is enabled, Telnyx takes into the account the health of a number when choosing a number from the pool. If a number is deemed unhealthy, it's skipped until it's deemed to be healthy again.

Note: If no number in the pool is deemed healthy, number pool will not choose a number and will reject the message.

To configure Number Pool in your Portal:

  1. 1Click on “Messaging” in the navigation menu on the left-hand side of the Telnyx Mission Control Portal.
  2. 2Click the edit symbol next to the Messaging Profile you want to use.
  3. 3Under Outbound, toggle on “Number Pool” to enable.
  4. 4Once enabled, you can adjust the weighting of long code and toll-free numbers. For higher delivery rates, you can also select “Skip Unhealthy Numbers” to exclude any numbers with low delivery rates.
  5. 5Click “Save”.

number pool

That’s it. You’re all set to use Number Pool.

Was this page helpful?was-this-page-helpful