---
title: "List webhooks"
method: GET
path: "/v1/webhooks"
---

# List webhooks

`GET /v1/webhooks`

## Request

- Base URL: `https://api.ploti.ai`
- URL: `https://api.ploti.ai/v1/webhooks`
- Auth: HTTP bearer

The member's webhooks, each with its id, url, description, header name, when it was created, and its last delivery (event, state, attempts, last status or error). Secrets are never repeated; a new secret means a new webhook.

## Response `200`

Done

- object
  - `webhooks` object[], required
    - `id` string, required
    - `url` string, required
    - `description` string, nullable, required
    - `headerName` string, nullable, required
    - `subscriptionId` string, nullable, required: The Data Feeds subscription whose events it receives, if any.
    - `events` string[], nullable, required: The Data Feeds event types it receives; every one when null.
    - `createdAt` string, required
    - `lastDelivery` object, nullable, required: The newest event: pending (waiting for its next try), sending, delivered, or failed after its retries.
      - `eventType` string, required
      - `state` 'pending' | 'sending' | 'delivered' | 'failed', required
      - `attempts` integer, required
      - `lastStatus` integer, nullable, required
      - `lastError` string, nullable, required
      - `createdAt` string, required

## Other responses

- `401`: The credential is missing or not valid.
- `413`: payload_too_large: the body is over 256 KB (2 MB for /v1/tools).
- `415`: unsupported_media_type: a body was sent without Content-Type: application/json.
- `429`: rate_limited: this credential is over its rate. Retry after the Retry-After header's seconds.
- `500`: internal: Ploti failed. Retry; if it keeps happening, contact support.
- `default`: Refused: nothing was done. The code says why and the links say where the person acts on it.

---

[API](https://skmtc.dev/ploti/apis/ploti-api.md) · [All operations](https://skmtc.dev/ploti/apis/ploti-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ploti/apis/ploti-api/revisions/8c2c91c72d52?raw)