Skip to main content
POST
Purchase an available phone number and add it to your account. Use the Search Numbers endpoint first to find available numbers.

Request Body

string
required
The phone number to provision from search results.Example: +16045551234
string
Display name for the number.Example: Main Line
string
Agent UUID to assign to this number immediately.

Response

Returns the provisioned phone number object.
string
Unique identifier for this phone number.
string
The phone number in E.164 format.
string
Display name.
string
Assigned agent UUID (if any).
object
Number capabilities: voice, sms, mms.
boolean
Whether the number is active.
string
ISO 8601 timestamp when provisioned.