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

# List webhooks

`GET /v1/webhooks`

## Request

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

List the webhooks you made in this account, newest first.

A Business Owner or Admin sees every member's webhooks, including departed members'. Signing secrets are never returned.

## Query parameters

- `cursor` string
- `limit` string

## Response `200`

One page of webhooks

- object
  - `data` Webhook[], required
    - `id` string, required: a webhook ID: wh_ and 32 lowercase hex digits
    - `created_by` WebhookCreator, required: The member who made the webhook. Only they can change, test or rotate it, and it carries events for the jobs they can see
      - `user_id` string, required: The member's user ID
      - `email` string, nullable, required: The email they sign in with, or null when the account no longer has it
    - `url` string, required
    - `events` string[], required
    - `status` 'active' | 'disabled', required
    - `disabled_reason` 'manual' | 'gone' | 'unreachable' | 'secret_unreadable', nullable, required: Why a disabled webhook sends nothing: manual (turned off), gone (its receiver answered 410), unreachable (20 failed deliveries in a row) or secret_unreadable (rotate its secret)
    - `created_at` string, required: a string to be decoded into a Date
    - `last_delivery_at` string, required: a string to be decoded into a Date
  - `next_cursor` string, nullable, required

## Other responses

- `400`: invalid_request
- `401`: unauthorized, reauthentication_required
- `403`: webhooks_unavailable, forbidden
- `500`: internal_error
- `503`: temporarily_unavailable

---

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