curl -X POST "https://api.wirebox.sh/api/v1/phone/numbers" \
-H "Authorization: Bearer $WIREBOX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"agent_handle":"eva","country_code":"US","region":"CA"}'
{
"id": "pn_01J8ABC123DEF456",
"phone_number": "+14155550123",
"country_code": "US",
"type": "local",
"region": "CA",
"agent_handle": "eva",
"agent_identity_id": "agt_01J8ABC123DEF456",
"status": "active",
"sms_status": "pending",
"capabilities": { "sms": true, "mms": true, "voice": false },
"created_at": "2026-09-14T10:00:00Z",
"updated_at": "2026-09-14T10:00:00Z"
}
Phone
Provision a Phone Number
Provision a phone number and attach it to an agent identity.
POST
/
api
/
v1
/
phone
/
numbers
curl -X POST "https://api.wirebox.sh/api/v1/phone/numbers" \
-H "Authorization: Bearer $WIREBOX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"agent_handle":"eva","country_code":"US","region":"CA"}'
{
"id": "pn_01J8ABC123DEF456",
"phone_number": "+14155550123",
"country_code": "US",
"type": "local",
"region": "CA",
"agent_handle": "eva",
"agent_identity_id": "agt_01J8ABC123DEF456",
"status": "active",
"sms_status": "pending",
"capabilities": { "sms": true, "mms": true, "voice": false },
"created_at": "2026-09-14T10:00:00Z",
"updated_at": "2026-09-14T10:00:00Z"
}
Phone numbers support inbound SMS and MMS. Outbound SMS is not currently available.
The number becomes SMS-ready asynchronously. Check
Request body
string
required
Handle of the agent identity that will own the number. A leading
@ is optional.string
default:"US"
Country code. Supported values are
US and CA.string
default:"local"
Number type:
local or toll_free.string
Two-letter US state or Canadian province code, such as
CA or ON.string
Three-digit area code. Do not provide this together with
region.curl -X POST "https://api.wirebox.sh/api/v1/phone/numbers" \
-H "Authorization: Bearer $WIREBOX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"agent_handle":"eva","country_code":"US","region":"CA"}'
{
"id": "pn_01J8ABC123DEF456",
"phone_number": "+14155550123",
"country_code": "US",
"type": "local",
"region": "CA",
"agent_handle": "eva",
"agent_identity_id": "agt_01J8ABC123DEF456",
"status": "active",
"sms_status": "pending",
"capabilities": { "sms": true, "mms": true, "voice": false },
"created_at": "2026-09-14T10:00:00Z",
"updated_at": "2026-09-14T10:00:00Z"
}
sms_status or subscribe to the number.sms_ready webhook before relying on inbound delivery.