# List subscribable event types.

`GET /webhook_events`

> Wheelhouse Revenue Management API. Web version: https://docs.usewheelhouse.com/rm/reference/rm-get-webhook-events · OpenAPI spec: https://docs.usewheelhouse.com/rm/openapi.yaml · Operation ID: `rmGetWebhookEvents` · Tag: Webhooks

Returns every event type a webhook subscription can ask for, with the object its ids refer to and how long events of that type are batched before being sent. Use the `event_type` values in `event_types` when creating or updating a subscription.

The response does not describe what triggers each event — see [What fires each event](https://docs.usewheelhouse.com/rm/reference/webhooks.md) for the trigger conditions, including what does not fire each one.

## Request

`GET https://api.usewheelhouse.com/ss_api/v1/webhook_events`

Authentication: send your RM API key in the `X-Integration-Api-Key` header (see https://docs.usewheelhouse.com/rm/authentication.md). Read-only keys can call this endpoint.

### Example request

```bash
curl -X GET 'https://api.usewheelhouse.com/ss_api/v1/webhook_events' \
  -H 'X-Integration-Api-Key: <your RM API key>'
```

Only required parameters and body fields are filled in, with placeholder values. Add the optional ones you need from the lists above; some are required in combination, as their descriptions say.

## Responses

### 200

Array of subscribable event types.

Body (`application/json`): array of object `webhook_event_type`

An event type a webhook subscription can ask for.

- `event_type` (string, required, one of: `recommendations.updated`, `reservations.ingested`, `flags.detected`): Identifier used in `event_types` when creating or updating a subscription, and sent
  as the `type` field of the delivery envelope. See
  [What fires each event](https://docs.usewheelhouse.com/rm/reference/webhooks.md) for what triggers each one.
- `subject` (string, required, example: `listing`): The kind of object the event's ids refer to.
- `batch_window_seconds` (integer, required, example: `300`): How long events of this type are batched before being sent. Deliveries name every
  listing affected within the window.

Example shape (generated from the schema; placeholder values, not a real response):

```json
[
  {
    "event_type": "recommendations.updated",
    "subject": "listing",
    "batch_window_seconds": 300
  }
]
```

### 401

API key authorization failed.

### 429

Rate limit exceeded — the API key has sent too many requests. Wait before retrying. See the **Rate Limits** section in the overview for the recommended exponential backoff strategy.

Body (`application/json`): object

- `error` (string, example: `API token is at rate limit`)

Example shape (generated from the schema; placeholder values, not a real response):

```json
{
  "error": "API token is at rate limit"
}
```
