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

# List webhooks

`GET /v1/webhooks`

## Request

- Base URL: `https://api.postzen.dev`
- URL: `https://api.postzen.dev/v1/webhooks`
- Auth: HTTP bearer

Returns webhook endpoints visible to the API key, newest first. Secret and custom header values are never returned.

## Response `200`

Webhooks returned.

- WebhooksListResponse
  - `webhooks` Webhook[], required
    - `id` string, required
    - `name` string, required
    - `url` string, uri, required
    - `events` WebhookEvent[], required
    - `profileAccess` 'all_profiles' | 'selected_profiles', required
    - `profileIds` string[], required: Selected profile ids. Empty when profileAccess is all_profiles.
    - `hasSigningSecret` boolean, required: Whether PostZen signs deliveries for this endpoint. The secret itself is never returned.
    - `customHeaderNames` string[], required: Configured custom header names. Header values are never returned.
    - `isActive` boolean, required
    - `disabledReason` 'auto_consecutive_failures' | 'user_disabled'
    - `consecutiveFailures` integer, required
    - `lastDeliveredAt` string, date-time
    - `lastFailedAt` string, date-time
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

- `401`: Missing or invalid API key.
- `500`: Unexpected server error.

---

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