Schedule an outbound call to a contact

POST

/users/me/contacts/{id}/schedule-call

Queues an outbound call targeted at this contact. Wraps POST /calls/schedule and auto-fills phoneNumber from the contact record, plus injects contact context (name, tags, last interaction) so the agent knows who it's calling. The resulting Call is linked to the contact — shows up in their timeline, counts toward lifecycle stats. Agent must be isActive and owned by the caller; contact must have a valid E.164 phone.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢201

This response does not have a body.

Request Example

Shell

JavaScript

Java

Swift

curl --location '/users/me/contacts//schedule-call' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "goal": "string",
    "scheduledAt": "string",
    "agentId": "string",
    "firstMessage": "string",
    "additionalContext": "string"
}'

Modified at 2026-07-23 18:02:16

Create or update email receptionist settings for an agent

Send an SMS to a contact