post
https://api.emaktalk.com/api/v1/numbers/orders
Orders a phone number from a recent availability search and starts billing for it.
This spends money and can't be undone through this API. To stop paying for a number, disconnect it.
Use it:
- Search with
POST /api/v1/numbers/available/localor/toll_free. - Order a number from those results. If it has aged out of the saved results, you get a 404: search again and reorder.
- On an account that routes calls only through call flows, choose the number's call flow in
call_flow_uuid.
Notes:
- A 200 means the carrier accepted the order, not that the number is ready to take calls.
- Needs an API key with the Admin role, and an account with a billing customer. Sending
customerIddoesn't work around that.
Accounts that route calls only through call flows:
call_flow_uuidis checked before anything is ordered, and the number arrives attached to that call flow.- No published call flow yet? Leave it out: the number arrives attached to a new "Default call flow", which simply hangs up and which you can edit like any other.
- If your chosen call flow is deleted, or can no longer take numbers, before the number arrives, the number goes to the Default call flow instead.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Missing or invalid API key.