---
title: "List webhooks for the authenticated user."
method: GET
path: "/xrpc/place.stream.server.listWebhooks"
tags: ["place.stream.server"]
---

# List webhooks for the authenticated user.

`GET /xrpc/place.stream.server.listWebhooks`

## Query parameters

- `limit` integer — The number of webhooks to return.
- `cursor` string — An optional cursor for pagination.
- `active` boolean — Filter webhooks by active status.
- `event` 'chat' | 'livestream' | 'follow' | 'mention' | 'stream.received' — Filter webhooks that handle this event type.

## Response `200`

Success

- object
  - `webhooks` PlaceStreamServerDefsWebhook[], required
    - `id` string, required — Unique identifier for this webhook.
    - `url` string, uri, required — The webhook URL where events will be sent.
    - `events` string[], required — The types of events this webhook should receive.
    - `active` boolean, required — Whether this webhook is currently active.
    - `prefix` string — Text to prepend to webhook messages.
    - `suffix` string — Text to append to webhook messages.
    - `rewrite` PlaceStreamServerDefsRewriteRule[] — Text replacement rules for webhook messages.
      - `from` string, required — Text to search for and replace.
      - `to` string, required — Text to replace with.
    - `createdAt` string, date-time, required — When this webhook was created.
    - `updatedAt` string, date-time — When this webhook was last updated.
    - `name` string — A user-friendly name for this webhook.
    - `description` string — A description of what this webhook is used for.
    - `lastTriggered` string, date-time — When this webhook was last triggered.
    - `errorCount` integer — Number of consecutive errors for this webhook.
    - `muteWords` string[] — Words to filter out from chat messages. Messages containing any of these words will not be forwarded.
  - `cursor` string — A cursor for pagination, if there are more results.

## Other responses

- `400` — Bad Request

## Changes

> 52 revisions in range; 3 could not be searched.

- **2026-07-10** `0eb3e511bec2` — 1 warning, 1 info
  - added the new `stream.received` enum value to the `webhooks/items/events/items/` response property for the response status `200`
  - added the new enum value `stream.received` to the `query` request parameter `event`
- **2026-04-20** `3353f5f6354a` — 1 breaking, 14 info
  - the `webhooks/items/` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - added the optional property `webhooks/items/description` to the response with the `200` status
  - added the optional property `webhooks/items/errorCount` to the response with the `200` status
  - added the optional property `webhooks/items/lastTriggered` to the response with the `200` status
  - …11 more
- **2026-01-21** `b21cd7605630` — 1 breaking, 1 info
  - removed the enum value `stream.received` from the `query` request parameter `event`
  - removed the `stream.received` enum value from the `webhooks/items/events/items/` response property for the response status `200`

[Change history](https://skmtc.dev/streamplace/apis/generated-lexicon-api-schema/changes/xrpc/place.stream.server.listWebhooks/get.md)

---

[API](https://skmtc.dev/streamplace/apis/generated-lexicon-api-schema.md) · [All operations](https://skmtc.dev/streamplace/apis/generated-lexicon-api-schema/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/streamplace/generated-lexicon-api-schema/revisions/8e2ce7f5d85b/schema)