Phone Numbers
Create a Phone Number Order
deprecated
Purchase and provision a phone number through the v1 phone number order API.
POST
Purchase a phone number from the specified provider (V1 alias)
Creates a phone number order for the selected telephony provider and provisions the resulting number in the workspace. Use this v1 order path for new integrations.
The older
/organization-phone-numbers/purchase path remains documented for existing integrations during the legacy transition.Related endpoints
- Search Available Numbers: find numbers before ordering.
- Purchase a Number: legacy purchase path.
- Link a SIP Trunk: connect a bring-your-own number.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
RSA encrypted organization ID (base64 format)
Example:
"BASE64_ENCRYPTED_ORG_ID_HERE"
Body
application/json
Purchase a phone number from the specified provider (V1 alias)