Call Create

POST

/calls

Initiates a call to the provided phone_number using the given assistant_id. The endpoint processes additional key+values flexibly and passes them through to the assistants' knowledge. A provided key (e.g. interests) can then be references within the assistants know-how by placing the key in curly braces (e.g. {interests})

Request

Authorization

Add parameter in header

Authentication

Example:

Authentication: ********************

Body Params application/json

assistant_id

string

required

The assistants id

phone_numer

string

required

The number to be called in E.164 format (e.g. +491601234567)

any additional <key>

string

optional

Will get passed on to the assistant and can get addressed via {key}

Example

{
    "assistant_id": "GSeJLCEYc3TsXrF187ru",
    "phone_number": "+49170123456",
    "interests": "oldtimer"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/calls' \
--header 'Content-Type: application/json' \
--header 'Authentication;' \
--data-raw '{
    "assistant_id": "GSeJLCEYc3TsXrF187ru",
    "phone_number": "+49170123456",
    "interests": "oldtimer"
}'

Responses

🟢200Success

application/json

Body

object {0}

Example

{}

Modified at 2025-06-05 14:54:20

Authentication

Calls List