> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getkarta.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Call events

> Receive call events at your configured webhook URL.

## Receiving URL

Karta sends events to the webhook URL configured for your account. For example:

```http theme={null}
POST https://your-server.example/webhooks/karta
```

This is an example customer endpoint, not a Karta API URL. Your application hosts this endpoint; its domain and path depend on your integration.

Karta sends a JSON body. Verify its signature and return `200 OK` after accepting the event.

## Call events

Subscription names and delivered `event` values differ:

| Subscription | Delivered `event` |
| - | - |
| `voice.call.started` | `call_request_received` |
| `voice.call.ended` | `call_ended` |
| `voice.call.failed` | `sip_call_failed` |
| `voice.call.not_connected` | `voice_call_not_connected` |
| `voice.call.transfer.initiated` | `call_transfer_initiated` |
| `voice.call.transfer.success` | `call_transfer_success` |
| `voice.call.transfer.failed` | `call_transfer_failed` |
| `voice.call.transfer.cancelled` | `call_transfer_cancelled` |

Call fields vary by event. Recording and transcript links may be included when available.

See [Receive call webhooks](https://docs.getkarta.ai/guides/webhooks/overview.md) for signature verification and duplicate handling.


## OpenAPI

````yaml openapi.json webhook callEvent
openapi: 3.1.0
info:
  title: Karta Public API
  version: 1.0.0-draft
  description: >-
    Karta API reference for accounts, agents, calls, campaigns, WebSocket
    sessions, and billing.
servers:
  - url: https://api.getkarta.ai/public/v1
    description: Production
security:
  - BearerApiKey: []
tags:
  - name: Account
  - name: Agents
  - name: Calls
  - name: Phone numbers
  - name: Campaigns
  - name: Realtime
  - name: Billing
  - name: Webhooks
    description: Outgoing call events delivered to your server.
paths: {}
components:
  securitySchemes:
    BearerApiKey:
      type: http
      scheme: bearer
      description: 'API key in the format: Bearer YOUR_KARTA_API_KEY.'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.