POST
/
v1
/
calls
curl --request POST \
  --url https://api.bland.ai/v1/calls \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '{
  "phone_number": "<string>",
  "task": "<string>"
}'
{
  "status": "success",
  "call_id": "9d404c1b-6a23-4426-953a-a52c392ff8f1"
}

Headers

authorization
string
required

Your API key for authentication.

Body

phone_number
string
required

The phone number to call. Country code defaults to +1 (US) if not specified.

Formatting is flexible, however for the most predictable results use the E.164 format.

task
string
required

Provide instructions, relevant information, and examples of the ideal conversation flow.

Response

status
string

Can be success or error.

call_id
string

A unique identifier for the call (present only if status is success).

{
  "status": "success",
  "call_id": "9d404c1b-6a23-4426-953a-a52c392ff8f1"
}