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

# Event catalog

> Webhook and timeline event names.

These event names can appear in the token timeline. The same list is accepted when creating a webhook.

| Event              | When it fires                                     |
| ------------------ | ------------------------------------------------- |
| `session.created`  | A token is created.                               |
| `session.deleted`  | A token is deleted.                               |
| `connection.state` | Runtime connection changes.                       |
| `auth.qr`          | A new pairing QR is generated.                    |
| `auth.paired`      | WhatsApp credentials are paired.                  |
| `message.received` | The connected device receives an inbound message. |
| `message.sent`     | An outgoing message is accepted by WhatsApp.      |
| `message.receipt`  | WhatsApp sends a delivery/read receipt.           |
| `message.failed`   | An outgoing send fails.                           |
| `stanza.error`     | WhatsApp returns a protocol-level error.          |
| `stream.failure`   | The runtime stream fails.                         |