---
title: "List subscribable event types"
method: GET
path: "/webhooks/event-types"
tags: ["webhooks"]
---

# List subscribable event types

`GET /webhooks/event-types`

## Request

- Base URL: `/api/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/webhooks/event-types`
- Auth: API key in header `X-Axilio-Api-Key`
- TypeScript: <https://skmtc.dev/axilioai/apis/axilio-api/docs/webhooks/event-types/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the event types an endpoint can subscribe to, with a description of each, so a caller knows what to subscribe to before registering an endpoint.

## Response `200`

OK

- WebhookEventTypeCatalogResponse: The catalog of event types an endpoint can subscribe to.
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `event_types` WebhookEventTypeDescriptor[], nullable, required: Subscribable event types.
    - `description` string, required: What the event means and when it fires.
    - `domain` 'platform' | 'runs' | 'sessions' | 'billing' | 'files' | 'phones' | 'messages' | 'schedules', required: The area of the product the event belongs to, for grouping: platform, runs, sessions, billing, files, phones or messages.
    - `sample` unknown
    - `type` string, required: Event type wire value (e.g. webhook.test).

## Other responses

- `default`: Error

## Changes

- **2026-11-01** `80de09d0e643`: 1 warning
  - added the new `schedules` enum value to the `event_types/items/domain` response property for the response status `200`
- **2026-10-23** `49b1da5a7974`: 1 warning
  - added the new `messages` enum value to the `event_types/items/domain` response property for the response status `200`
- **2026-09-27** `7abfd1e84b24`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/axilioai/apis/axilio-api/changes/webhooks/event-types/get.md)

---

[API](https://skmtc.dev/axilioai/apis/axilio-api.md) - [All operations](https://skmtc.dev/axilioai/apis/axilio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/axilioai/apis/axilio-api/revisions/80de09d0e643?raw)
