wirebox phone provision --agent eva --country US --region CA
import { Wirebox } from "@wirebox-sh/sdk";
const wb = new Wirebox();
const number = await wb.phone.numbers.provision({
agent_handle: "eva",
country_code: "US",
region: "CA",
});
from wirebox import Wirebox
with Wirebox() as wb:
number = wb.phone.numbers.provision(
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
wirebox phone provision --agent eva --country US --region CA
import { Wirebox } from "@wirebox-sh/sdk";
const wb = new Wirebox();
const number = await wb.phone.numbers.provision({
agent_handle: "eva",
country_code: "US",
region: "CA",
});
from wirebox import Wirebox
with Wirebox() as wb:
number = wb.phone.numbers.provision(
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.wirebox phone provision --agent eva --country US --region CA
import { Wirebox } from "@wirebox-sh/sdk";
const wb = new Wirebox();
const number = await wb.phone.numbers.provision({
agent_handle: "eva",
country_code: "US",
region: "CA",
});
from wirebox import Wirebox
with Wirebox() as wb:
number = wb.phone.numbers.provision(
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.