---
title: "List the caller's Webhooks"
method: GET
path: "/api/v1/webhooks"
---

# List the caller's Webhooks

`GET /api/v1/webhooks`

## Request

- Base URL: `https://charm.ing`
- URL: `https://charm.ing/api/v1/webhooks`
- Auth: HTTP bearer

Session-gated. Lists every Webhook on an app the caller can edit (holds `app:write` on): their own apps, their teams' apps, and apps shared with them as a collaborator.

## Response `200`

The caller's Webhooks.

- WebhookListResponse: The caller's Webhooks, and the Webhook ceilings their plan allows.
  - `ok` true, required
  - `webhooks` Webhook[], required
    - `id` string, required: Public id, `webhook_<uuid>` form.
    - `app_id` string, uuid, required
    - `op` string, required
    - `name` string, required: The owner’s label; defaults to the op’s title, description, or identifier.
    - `url` string, required: The delivery URL an external sender POSTs to.
    - `secret_prefix` string, required: First characters of the secret, for matching a stored copy by eye.
    - `enabled` boolean, required
    - `disabled_reason` 'owner' | 'null', nullable, required
    - `last_run_at` string, date-time, nullable, required
    - `last_outcome` string, nullable, required
    - `last_error` object, nullable, required
      - `kind` string, required
      - `message` string, required
    - `consecutive_failures` integer, required
  - `limits` object, required: The caller's own Webhook ceilings, resolved from their plan. Read these rather than assuming a tier.
    - `webhooks_per_app` integer, required
    - `webhooks_per_owner` integer, required

## Other responses

- `401`: Sign-in required.

---

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