Skip to main content
POST
Purchase a quoted Telnyx number

Authorizations

Authorization
string
header
required

A Contact Button scoped bearer key. Send Authorization: Bearer <token>. Token abilities are enforced independently of workspace membership; both checks must pass. OAuth 2.0 authorization-code flows are not currently available.

Headers

Idempotency-Key
string

Stable 8–120 character key for safe mutation retries.

Required string length: 8 - 120

Path Parameters

workspace
string<uuid>
required

Body

application/json
quote
string<uuid>
required

Unexpired opaque quote ID returned by phone-number search.

label
string
required
Maximum string length: 120
call_flow_id
string<uuid>
required

Public UUID returned by a call-flow operation.

confirm_price
boolean
required

Send only after the human explicitly approves the quoted recurring and upfront charges.

Response

Successful data envelope.

data
any
required
meta
object
required