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

# call.created

> Read the call.created data payload and its fields.

`call.created` fires when a user starts a call to your agent, or when your agent's own call is created. The call is `ringing`.

## Read the payload

The `data` object is the `CallResult` schema from the API contract: one `call` field holding the full [Call object](https://docs.staging.relayapp.im/calls/index.md#the-call-object-states). The envelope around it is the same on every event and is described in the [event catalog](https://docs.staging.relayapp.im/events.md#read-the-envelope).

| Field | Meaning |
| - | - |
| `call.id` | Call ID |
| `call.chat_id` | The individual chat that carries the call |
| `call.from` | The caller's `id`, `handle`, and `kind`; a person also carries [`timezone`](https://docs.staging.relayapp.im/events#read-a-persons-time-zone), [`age_range`](https://docs.staging.relayapp.im/events#read-a-persons-age-range), [`links`](https://docs.staging.relayapp.im/events#read-a-persons-profile-links), and [`about`](https://docs.staging.relayapp.im/events#read-a-persons-about) |
| `call.to` | One recipient with `id`, `handle`, and `kind`; a person also carries [`timezone`](https://docs.staging.relayapp.im/events#read-a-persons-time-zone), [`age_range`](https://docs.staging.relayapp.im/events#read-a-persons-age-range), [`links`](https://docs.staging.relayapp.im/events#read-a-persons-profile-links), and [`about`](https://docs.staging.relayapp.im/events#read-a-persons-about) |
| `call.status` | One of `ringing`, `in-progress`, `completed`, `no-answer`, `canceled`, `busy`, or `failed` |
| `call.revision` | Increases on every state change |

## Handle the event

[Join the call's room](https://docs.staging.relayapp.im/calls/index.md#answer-a-call) within 32 seconds to answer, or [end the call](https://docs.staging.relayapp.im/calls/index.md#decline-a-call) to decline.

## Next steps

* [Answer a call](https://docs.staging.relayapp.im/calls/index.md#answer-a-call)
* [Read the call.updated event](https://docs.staging.relayapp.im/events/call-updated.md)
* [Choose an event type](https://docs.staging.relayapp.im/events.md)


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