

Number Types
Pingtree supports two types of DID numbers:| Type | Area Codes | Typical Use |
|---|---|---|
| Local | Any standard geographic area code | Geo-targeted campaigns requiring a familiar local presence |
| Toll-Free | 800, 833, 844, 855, 866, 877, 888 | National campaigns where callers expect a free-to-dial number |
Number Statuses
Every DID number moves through a status lifecycle:| Status | Meaning |
|---|---|
| Pending | The order has been placed with Telnyx and is being provisioned |
| Available | The number is active on Telnyx but not yet assigned to any source |
| Active | The number is assigned to a campaign source and ready to receive calls |
| Failed | The Telnyx order failed; the number cannot be used |
| Released | The number has been returned to Telnyx and permanently removed |
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.- Click Search Numbers to open the number search modal.
- Choose Local or Toll-Free as the number type.
- Enter an area code to search for available numbers in that region.
- Review the results. Each result shows the phone number, region information, and the upfront and monthly costs that will be charged to your wallet.
- Click Purchase next to the number you want.
- 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.- Go to the campaign source where you want to enable call tracking.
- Open the Manage Calls section for that source.
- Select an available DID number from the dropdown.
- Choose the campaign, source type, and optionally provide an internal label (Assigned Name) for easy reference.
- Save the assignment.
Viewing All Numbers
The DID Numbers list shows all numbers purchased by your organization, paginated and filterable:| Column | Description |
|---|---|
| Phone Number | The E.164-formatted DID number |
| Status | Current lifecycle status (color-coded badge) |
| Campaign | The offer campaign this number is assigned to, if any |
| Source | The campaign source this number is assigned to, if any |
| Purchased By | The team member who placed the order |
| Purchased At | Date and time of purchase |
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.
- Locate the number in the DID Numbers list.
- Click the Release action in the row menu.
- Confirm the release in the dialog.
Assignable vs. Assigned Numbers
| Category | Condition | Can Receive Calls? |
|---|---|---|
| Assignable | Status is Available, no campaign or source attached | No |
| Assigned | Status is Active, linked to a campaign + source | Yes |