DID Numbers

Documentation Index

Fetch the complete documentation index at: https://docs.pingtree.com/llms.txt

Use this file to discover all available pages before exploring further.

DID (Direct Inward Dialing) numbers are the phone numbers callers dial to reach your campaign. Pingtree purchases and manages these numbers through Telnyx on your behalf. From the DID Numbers page you can search for available numbers, purchase them, assign them to sources, and release them when they are no longer needed.

​

Number Types

Pingtree supports two types of DID numbers: Upfront and monthly charges differ between local and toll-free numbers. The current pricing for your organization is displayed in the search results before you confirm a purchase.

​

Number Statuses

Every DID number moves through a status lifecycle:

Tip: Numbers typically move from Pending to Available within seconds of purchase. Pingtree polls Telnyx automatically after the order is placed so the status updates without a manual refresh.

​

Purchasing a Number

Before purchasing, make sure your organization has a Call Control Application and a Billing Group configured. These are required for Telnyx to route calls correctly.

1. Click Search Numbers to open the number search modal.
2. Choose Local or Toll-Free as the number type.
3. Enter an area code to search for available numbers in that region.
4. Review the results. Each result shows the phone number, region information, and the upfront and monthly costs that will be charged to your wallet.
5. Click Purchase next to the number you want.
6. Confirm the purchase. The upfront cost is deducted from your wallet immediately.

Tip: Ensure your wallet has sufficient balance before purchasing. The system checks your balance before placing the order and will decline the purchase if funds are insufficient.

After purchase, the number appears in your DID Numbers list with a status of Pending, then Available once Telnyx confirms provisioning.

​

Assigning a Number to a Source

An Available number must be assigned to a campaign and source combination before it can receive traffic. Only unassigned numbers (those with no campaign or source attached) appear in the assignable list.

1. Go to the campaign source where you want to enable call tracking.
2. Open the Manage Calls section for that source.
3. Select an available DID number from the dropdown.
4. Choose the campaign, source type, and optionally provide an internal label (Assigned Name) for easy reference.
5. Save the assignment.

Once assigned, the number’s status changes to Active and call routing is live. Recording settings from the source’s call configuration are automatically applied to the number.

​

Viewing All Numbers

The DID Numbers list shows all numbers purchased by your organization, paginated and filterable: Use the Status filter to narrow the list to a specific lifecycle stage (e.g., show only Active numbers). You can also filter by Campaign to see all numbers attached to a particular offer.

​

Releasing a Number

Releasing permanently removes a number from your account and from Telnyx. Monthly charges stop after release.

Important: A number must be unassigned before it can be released. If the number is currently Active (assigned to a source), unassign it from the source’s Call Settings first.

1. Locate the number in the DID Numbers list.
2. Click the Release action in the row menu.
3. Confirm the release in the dialog.

The number is deleted from Telnyx and removed from your list. This action is irreversible — the number is returned to the Telnyx pool and may be reassigned to another customer.

​

Assignable vs. Assigned Numbers

Only assignable numbers appear in the source call settings dropdown. If a number you purchased does not appear in the dropdown, check that its status is Available and that it has not already been assigned elsewhere.