---
title: "List the connected account's webhooks"
method: GET
path: "/api/v1/webhooks"
tags: ["webhooks"]
---

# List the connected account's webhooks

`GET /api/v1/webhooks`

## Request

- Base URL: `https://www.listdrop.co`
- URL: `https://www.listdrop.co/api/v1/webhooks`
- Auth: OAuth 2 (authorization code, authorization URL `https://www.listdrop.co/oauth/authorize`, token URL `https://www.listdrop.co/api/oauth/token`, scopes: `lists:read`)

Every webhook this account registered, across all lists, with delivery health (failures, last status, disabledAt). Secrets are never shown again — delete and re-create to rotate one.

## Response `200`

The account's webhooks.

- WebhookList
  - `webhooks` object[], required
    - `id` string, required
    - `listId` string, required
    - `url` string, uri, required
    - `createdAt` string, date-time, required
    - `failures` integer, required: Consecutive delivery failures (10 disables the hook).
    - `disabledAt` string, date-time, nullable, required
    - `lastStatus` string, nullable, required: HTTP status or error code of the last delivery.
    - `lastDeliveryAt` string, date-time, nullable, required

## Other responses

- `401`: Missing/invalid bearer token, or missing the lists:read scope.

---

[API](https://skmtc.dev/listdrop/apis/listdrop-public-api.md) · [All operations](https://skmtc.dev/listdrop/apis/listdrop-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/listdrop/apis/listdrop-public-api/revisions/699b5367e2f3?raw)