---
title: "Call Events Callback"
method: POST
path: "/api/v1/retell/call-events"
---

# Call Events Callback

`POST /api/v1/retell/call-events`

## Request

- Base URL: `https://app.sagecare.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://app.sagecare.ai/api/v1/retell/call-events`
- Auth: none declared

## Request body

- RetellEvent
  - `event` 'call_started' | 'call_ended' | 'call_analyzed', required
  - `call` union, required
    - WebCall
      - `call_id` string, required
      - `agent_id` string, required
      - `agent_version` integer, required
      - `call_status` 'registered' | 'not_connected' | 'ongoing' | 'ended' | 'error', required
      - `agent_name` string, nullable
      - `metadata` object, nullable
      - `retell_llm_dynamic_variables` object, nullable
      - `collected_dynamic_variables` object, nullable
      - `duration_ms` integer, nullable
      - `disconnection_reason` string, nullable
      - `call_type` 'web_call', required
      - `access_token` string, required
    - PhoneCall
      - `call_id` string, required
      - `agent_id` string, required
      - `agent_version` integer, required
      - `call_status` 'registered' | 'not_connected' | 'ongoing' | 'ended' | 'error', required
      - `agent_name` string, nullable
      - `metadata` object, nullable
      - `retell_llm_dynamic_variables` object, nullable
      - `collected_dynamic_variables` object, nullable
      - `duration_ms` integer, nullable
      - `disconnection_reason` string, nullable
      - `call_type` 'phone_call', required
      - `from_number` string, required
      - `to_number` string, required
      - `direction` 'inbound' | 'outbound', required
      - `telephony_identifier` TelephonyIdentifier
        - `twilio_call_sid` string, nullable

## Response `200`

OK

---

[API](https://skmtc.dev/sagecare/apis/sage-api-v1.md) - [All operations](https://skmtc.dev/sagecare/apis/sage-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/sagecare/apis/sage-api-v1/revisions/36b26ceace69?raw)