Skip to main content
POST
Invoke new call attempt
POST /interviews/{id}/call-attempts is a permanent alias of this endpoint and keeps working unchanged, with the same scopes and the same response. See Resource names.
Creates a new call attempt on an existing phone conversation — a way to place a call by hand, or to schedule a retry after an attempt that did not connect.
ONLINE conversations: managing individual call attempts is forbidden on an ONLINE conversation. There, the whole conversation is the unit — use Delete Conversation.

Overview

This endpoint places a new call on a phone conversation. It is useful when:
  • A previous call attempt failed (e.g., no answer, busy) and you want to try again manually.
  • You want to override the automatic retry logic and trigger a call immediately.
  • You want to schedule a specific time for the next call attempt.

Constraints and Behavior

  • Queue management: invoking a new attempt cancels any attempt already scheduled on that conversation and replaces it.
  • In-progress protection: while a call is in progress on the conversation, a new attempt cannot be invoked.
  • Transactional Integrity: The creation of a call attempt and its synchronization with the processing queue is handled transactionally.

Examples

Immediate Call

Omit scheduledAt to trigger a call attempt as soon as possible:

Scheduled Call Attempt

Provide a future ISO 8601 timestamp to schedule the call for a specific time:
This endpoint does not apply the agent’s calling window either way. A scheduledAt you send is used exactly as given, including when it falls outside those hours. Omitting it dials as soon as capacity allows, which is the point of an explicit invoke, so that is not held back to the window either. Both are deliberate: you are asking for this call now, and the window governs the calls we schedule ourselves.
Next steps: follow the attempt by fetching the conversation through Get Conversation and reading its callAttempts array.

Authorizations

Authorization
string
header
required

API key for authentication using Bearer scheme

Path Parameters

id
string<uuid>
required

Query Parameters

companyId
string

Required for ATS API keys to specify which company to access. Ignored for standard company API keys.

Body

application/json
scheduledAt
string<date-time>

Optional scheduled time for the call attempt (ISO string). If not provided, call will be invoked immediately. When provided it is used exactly as sent, including when it falls outside the agent's calling window.

Example:

"2026-05-01T10:00:00Z"

Response

201 - application/json

Call attempt created successfully

success
boolean
message
string