Calls

Place a call

Places an autonomous outbound phone call. An AI voice agent dials the number and pursues the objective, acting on account data mid-call. Only call numbers that have consented to be contacted.

post/calls

Request

  • Base URL: https://api.crevio.co/v1
  • URL: https://api.crevio.co/v1/calls
  • Auth: API key in header Authorization

Headers

Idempotency-Keystring

Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.

Request body

to_numberstring nullable
objectivestring nullable
first_messagestring nullable
purposestring nullable

Response

Call placed

idstring required
objectstring required
direction'inbound' | 'outbound' required
status'queued' | 'scheduled' | 'ringing' | 'in_progress' | 'ended' | 'failed' required
to_numberstring nullable required
from_numberstring nullable required
objectivestring nullable required
summarystring nullable required
transcriptstring nullable required
recording_urlstring nullable required
ended_reasonstring nullable required
duration_secondsinteger nullable required
credits_chargedinteger nullable required
created_atstring date-time required
updated_atstring date-time required
customerstring nullable required

Changes

No recorded changes to this operation across all 2 revisions of this API.