Add phone number
Adds a phone number to your account and provisions it right away. A 201 means it’s active. If provisioning fails you get 422 and the number stays on your account as failed.
Authorizations
Use Authorization: Bearer tc_live_xxxxx
Headers
Makes a retry safe. A 2xx response is stored for 24 hours per account, and a retry with the same key gets it back with Idempotent-Replay: true instead of running again. Errors aren't stored, so a retry after one runs fresh. The key isn't tied to a path or body: use a new key for every different request. A malformed key gets 400.
8 - 255^[A-Za-z0-9_-]+$"a1b2c3d4-e5f6-7890-abcd-ef0123456789"
Body
Response
Phone number added successfully
Phone number UUID
The number in E.164
Carrier the number is on
Carrier display name
topcalls when you omitted voip_carrier_sid, otherwise byoc.
topcalls, byoc The number's ID in the phone system
Always active. A failed provisioning returns 422 instead.
active Your label
Account UUID