POST

Call Completed Trigger

Fires when a call handled by an Agent ends.

POSThttps://api.vantaxai.com/v1/workflows (trigger: call.completed)

Use the `call.completed` trigger to automate post-call work — log outcomes, send follow-up texts, or open tasks once a call wraps up. Scope it by `agent_id` so each Agent can have its own after-call Workflow. When the event fires, the Workflow's `trigger_event` includes the call summary payload below. Reference this trigger by setting `trigger.type` to `call.completed` on the Create Workflow endpoint.

Headers

Authorizationstringrequired
Bearer authentication with your secret API key.
example: Bearer vx_live_3fa9c2…
Content-Typestringrequired
Must be application/json for requests with a body.
example: application/json

Body Parameters

trigger.typestringrequired
Set to `call.completed` to use this trigger.
example: call.completed
trigger.config.agent_idstringoptional
Only fire for calls handled by this Agent.
example: agt_3d9b21
trigger.config.outcomestringoptional
Only fire for calls with this outcome.
completedno_answervoicemailtransferred
example: completed

Request

curl -X POST https://api.vantaxai.com/v1/workflows (trigger: call.completed) \
  -H "Authorization: Bearer vx_live_3fa9c2..." \
  -H "Content-Type: application/json" \
  -d '{
  "trigger.type": "call.completed",
  "trigger.config.agent_id": "agt_3d9b21",
  "trigger.config.outcome": "completed"
}'

const res = await fetch(
  "https://api.vantaxai.com/v1/workflows (trigger: call.completed)",
  {
  method: "POST",
  headers: {
    Authorization: "Bearer vx_live_3fa9c2...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "trigger.type": "call.completed",
    "trigger.config.agent_id": "agt_3d9b21",
    "trigger.config.outcome": "completed"
  }),
  }
);
const { data } = await res.json();

import { Vantax } from "@vantax/sdk";

const vantax = new Vantax({ apiKey: process.env.VANTAX_API_KEY! });
// POST /v1/workflows (trigger: call.completed)
const result = await vantax.request("POST", "/v1/workflows (trigger: call.completed)", {
  "trigger.type": "call.completed",
  "trigger.config.agent_id": "agt_3d9b21",
  "trigger.config.outcome": "completed"
});

from vantax import Vantax

vantax = Vantax(api_key=os.environ["VANTAX_API_KEY"])
# POST /v1/workflows (trigger: call.completed)
result = vantax.request("POST", "/v1/workflows (trigger: call.completed)", json={"trigger.type": "call.completed", "trigger.config.agent_id": "agt_3d9b21", "trigger.config.outcome": "completed"})

Response

{
  "type": "call.completed",
  "occurred_at": "2026-02-02T11:20:00Z",
  "sub_account_id": "sub_8a1f4c2e",
  "data": {
    "call_id": "call_8c12af",
    "agent_id": "agt_3d9b21",
    "contact_id": "ct_91ad22",
    "direction": "inbound",
    "duration_seconds": 142,
    "outcome": "completed",
    "summary": "Caller booked an intro call for Thursday at 3pm.",
    "recording_url": "https://cdn.vantaxai.com/recordings/call_8c12af.mp3"
  }
}

{
  "success": false,
  "message": "Validation failed",
  "errors": [
    { "field": "trigger.config.outcome", "message": "outcome must be one of completed, no_answer, voicemail, transferred" }
  ]
}