---
title: "List Messages"
method: GET
path: "/webhooks/messages"
tags: ["webhooks"]
---

# List Messages

`GET /webhooks/messages`

Retrieve all webhook messages for your organization.

Webhook messages represent payloads that were sent (or attempted to be sent)
to your subscribed endpoints. Each message contains the event type, payload data,
and delivery status information.

Use the `event_types` query parameter to filter messages by specific event types,
such as `sync.completed` or `sync.failed`.

## Query parameters

- `event_types` string[], nullable — Filter messages by event type(s). Accepts multiple values, e.g., `?event_types=sync.completed&event_types=sync.failed`.

## Response `200`

List of webhook messages

- WebhookMessage[]
  - `id` string, required — Unique identifier for this message (UUID format)
  - `event_type` string, required — The type of event (e.g., 'sync.completed', 'sync.failed')
  - `payload` object, required — The event payload data, matching what is delivered to webhooks. Structure varies by event_type.
  - `timestamp` string, date-time, required — When this message was created (ISO 8601 format, UTC)
  - `channels` string[], nullable — Channels this message was sent to (typically matches the event type)
  - `tags` string[], nullable — Tags associated with this message for filtering

## Other responses

- `422` — Validation Error
- `429` — Rate Limit Exceeded

---

[API](https://skmtc.net/airweave-ai/apis/airweave.md) · [All operations](https://skmtc.net/airweave-ai/apis/airweave/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/airweave-ai/airweave/versions/bf410c28c0c6/schema)
