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

# List registered webhooks

`GET /webhooks`

## Request

- Base URL: `https://post.adaptlypost.com/post/api/v1`
- URL: `https://post.adaptlypost.com/post/api/v1/webhooks`
- Auth: HTTP bearer

Requires the `webhooks.read` permission.

## Headers

- `X-Workspace-Id` string

## Response `200`

Registered webhooks

- object
  - `webhooks` Webhook[]
    - `id` string
    - `url` string
    - `active` boolean
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `lastSuccessAt` string, date-time, nullable
    - `lastFailureAt` string, date-time, nullable
    - `disabledAt` string, date-time, nullable

## Other responses

- `401`: Invalid or missing API key
- `403`: The key's role does not hold `webhooks.read`
- `429`: Rate limit exceeded

---

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