WARP

WARP guide

Managing Phone Numbers on WARP

How to search, assign, route, configure, protect, and release phone numbers on WARP.

Numbers move through a lifecycle on WARP: search inventory, assign numbers to your account, configure voice and messaging, protect important numbers, and release numbers you no longer need.

Search for Available Numbers

Open Numbers > Search numbers to search live inventory. You can filter by:

  • Area code (NPA)
  • State
  • Rate center

If you cannot find inventory in a specific rate center, broaden the search to the state or area code. Inventory changes over time, so a number that is unavailable today may be available later.

Search requires numbers:read. It does not claim numbers by itself.

Review and Assign

After selecting numbers, continue to the review page. Review all selected TNs, estimated recurring cost, and any route or feature choices before committing.

Assignment moves numbers from available inventory to your account. Newly assigned numbers do not automatically route voice or send SMS. Configure the services you need after assignment.

Individual assignment and bulk assignment require numbers:write. Bulk assignment uses a stable request so the portal can avoid accidental duplicate procurement.

Route Voice to a Trunk

Voice routing decides where inbound calls go. A number can be assigned to your account but still unrouted.

To receive calls, open the number detail page and route voice to the correct SIP trunk. For many numbers, use bulk routing. If you want to pause inbound calls without giving up the number, remove or change the route instead of releasing the number.

Voice routing uses numbers:write. You may also need trunks:read to choose the correct trunk from the portal.

Configure E911

E911 ties a number to the physical service address emergency responders should use. Configure E911 for any number a person may use to dial 911.

Use accurate physical addresses and update them when users move. Treat E911 as a safety requirement. If you are unsure whether an address is correct, resolve that before relying on the number for emergency calling.

Configure CNAM

CNAM controls the outbound caller-name associated with a number. Configure it on the number detail page when you want recipients to see a specific name.

Downstream carriers decide what caller-ID data they display, and propagation can take time. Configure CNAM early when a launch depends on recognizable outbound caller ID.

Enable SMS

SMS enablement is separate from voice routing. A number can have voice, SMS, or both. The voice trunk does not control SMS delivery.

To send application-to-person traffic at scale, the number also needs to be assigned to an approved 10DLC campaign. SMS enablement is the number-level switch; campaign assignment is the compliance and deliverability layer.

Set a Port-Out PIN

A port-out PIN protects a number from unauthorized movement. Anyone trying to transfer or port the number must present the correct PIN.

Set a PIN on important numbers and store it securely. WARP locks out PIN entry after 10 failed attempts for 15 minutes to slow guessing attacks. PIN changes require numbers:write and step-up verification.

Release a Number

Release a number only when you are done with it. Release returns it to inventory and stops it from belonging to your account. You may not be able to reclaim the same number later.

Before release:

  1. Confirm no users, systems, or campaigns depend on the number.
  2. Remove it from voice routing if needed.
  3. Remove it from messaging campaigns if needed.
  4. Export or record any information your team needs.

Scopes and API Reference

Read operations use numbers:read:

  • GET /v1/numbers/search
  • GET /v1/numbers
  • GET /v1/numbers/:tn
  • GET /v1/numbers/:tn/port-out-pin

Write operations use numbers:write; port-out PIN changes require step-up:

  • POST /v1/numbers/:tn/assign
  • POST /v1/numbers/bulk-assign
  • POST /v1/numbers/bulk-route
  • PATCH /v1/numbers/:tn
  • PATCH /v1/numbers/:tn/voice
  • DELETE /v1/numbers/:tn/voice
  • PATCH /v1/numbers/:tn/sms
  • DELETE /v1/numbers/:tn/sms
  • PUT /v1/numbers/:tn/port-out-pin
  • DELETE /v1/numbers/:tn/port-out-pin
  • POST /v1/numbers/:tn/release