Skip to main content
This walkthrough takes you from zero to a number mapped onto your own SIP carrier. You’ll need your API Token and Org-Handle - see Authentication.
1

Set your credentials

Every request uses these two headers (writes also send Content-Type: application/json):
Get your Org-Handle from Get All Organizations - the domain_handle field.
2

See the numbers available to you

List the unassigned numbers in your org’s pool. Note an id to use later.
See List Numbers.
3

Create a trunk (your SIP carrier credential)

The response returns the new trunk id (e.g. 21). Copy it. See Create Trunk.
4

Map a number to the trunk

Replace 21 with your trunk id and 501 with a number id from Step 2.
The response includes the origin endpoint - the SBC ingress your carrier sends inbound calls to, plus the accepted source IPs. See Attach Numbers to Trunk.
5

Confirm the lifecycle

Each number shows connection_state, termination kind, agent link, and sync_state. See Telephony Overview.

What next

Detach numbers

Step 1 - unmap numbers from the trunk, returning them to NOT_ASSIGNED.

Delete trunk

Step 2 - remove the trunk and its credential once numbers are detached.