Bundles with porting orders

Associate bundles with porting phone numbers so bundle pricing is automatically applied when the port completes

Overview

Bundle pre-configuration allows you to associate bundles with phone numbers on a porting order before those numbers are active at Telnyx. When the port completes and the phone numbers become active, the pre-configured bundles are automatically applied.

The term “pre-configure” is used because bundles are not actually applied to phone numbers until after the numbers port in and become active at Telnyx. During the porting process, the bundle association exists as a pending configuration that takes effect upon port completion.

Constraints

• Bundle pre-configuration is only available via API.
• Bundles can be pre-configured or updated at any point before the porting order reaches ported or cancelled status, including shortly before the FOC date.
• Each bundle can only be associated with one phone number. If a pre-configured bundle is used elsewhere before the port completes, the assignment will fail.
• You can pre-configure up to 20 phone numbers per API request.
• The bundle must be valid for the specific phone number type and characteristics. Invalid bundle-number combinations will return an error.
• Pre-configuring bundles is optional. You can pre-configure bundles for some, all, or none of the phone numbers on a porting order.

How it works

Step 1: Verify available bundles

Use the GET /v2/bundle-pricing/user_bundles endpoint to list your bundles, or view them on the Bundles page in Mission Control Portal.

A bundle is available for pre-configuration if its resources array is empty. Each bundle has eligibility criteria for which phone numbers it can be assigned to. To purchase additional bundles, visit the Bundle Orders page.

Step 2: Get porting phone number IDs

Each phone number on a porting order has a unique porting_phone_number_id that you need for pre-configuration.

Use the GET /v2/porting_phone_numbers endpoint with a filter for your porting order ID to retrieve the list of phone numbers and their associated IDs.

Step 3: Pre-configure bundles

Use the POST /v2/porting_orders/phone_number_configurations endpoint to associate bundles with porting phone numbers. Each configuration requires:

• porting_phone_number_id: The ID of the phone number on your porting order.
• user_bundle_id: The ID of the bundle to pre-configure.

Step 4: Verify configurations

Use the GET /v2/porting_orders/phone_number_configurations endpoint with your porting order ID to view which bundles are pre-configured with which phone numbers.

When the port completes and phone numbers become active at Telnyx, the pre-configured bundles are automatically applied to the corresponding phone numbers.