POST
/
v1
/
calls
/
create
curl --request POST \
  --url https://api.vocode.dev/v1/calls/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "from_number": "<string>",
  "to_number": "<string>",
  "agent": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "not_started",
  "error_message": "<string>",
  "recording_available": false,
  "transcript": "<string>",
  "to_number": "<string>",
  "from_number": "<string>",
  "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"
    }
  }
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
from_number
string
required
​
to_number
string
required
​
agent
required

Response

200
application/json
Successful Response
​
id
string
required
​
user_id
string
required
​
to_number
string
required
​
from_number
string
required
​
agent
object
required
​
status
enum<string>
default:not_started

An enumeration.

Available options:
not_started,
in_progress,
error,
ended
​
error_message
string
​
recording_available
boolean
default:false
​
transcript
string