# List webhook events

`GET /v1/webhooks/events`

Event types a subscription may listen for, each with what fires it and an example delivery body, plus the "*" wildcard that also covers events added later. Each event's full schema is in this document's `webhooks` section. Any valid key.

## Returns

Returns `200 OK` with a `WebhookEventCatalogue` in `data`. Otherwise returns an error; [Errors](/docs/api/errors) lists every code and which to retry.

- `events` (object[], required)
  - `value` (string, required, one of `contact.created`, `contact.unsubscribed`, `contact.consent_changed`, `form.submitted`, `campaign.sent`, `journey.enrolled`, `message.delivered`, `message.bounced`, `message.complained`, `message.opened`, `message.clicked`, `message.failed`, `message.skipped`, `message.sent`) — The event type, such as `message.delivered`.
  - `resource` (string, required) — The part of the event type before the dot.
  - `action` (string, required) — The part of the event type after the dot.
  - `description` (string, required) — What fires the event.
  - `example` (object, required) — A whole delivery body: trigger samples for Zapier, Make and n8n.
- `wildcard` ("*", required)

## Example

```bash
curl https://api.kirora.io/v1/webhooks/events \
  -H "Authorization: Bearer $KIRORA_API_KEY"
```

Response `200`:

```json
{
  "data": {
    "events": [
      {
        "value": "contact.created",
        "resource": "resource_example",
        "action": "action_example",
        "description": "description_example",
        "example": {}
      }
    ],
    "wildcard": "*"
  }
}
```