POST
/
v1
/
numbers
/
buy
curl --request POST \
  --url https://api.vocode.dev/v1/numbers/buy \
  --header 'Authorization: Bearer <token>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "active": true,
  "inbound_agent": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "prompt": "<string>",
    "actions": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "type": "action_end_conversation",
        "config": {
          "phone_number": "<string>"
        }
      }
    ],
    "voice": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "type": "voice_base",
      "voice_name": "<string>",
      "pitch": 0,
      "rate": 15
    },
    "initial_message": "<string>",
    "webhook": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "subscriptions": [
        "event_message"
      ],
      "url": "<string>",
      "method": "GET"
    }
  },
  "number": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

200 - application/json
Successful Response
​
id
string
required
​
user_id
string
required
​
inbound_agent
object
required
​
number
string
required
​
active
boolean
default:true