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

# List webhooks

`GET /api/webhooks`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/webhooks`
- Auth: HTTP bearer

List all webhook endpoints configured for your account. Returns URL, subscribed events, and active status for each webhook. Secrets are never returned after creation. A mailbox-confined token sees only the webhooks confined to its own mailboxes.

## Response `200`

List of webhooks

- object
  - `webhooks` object[]
    - `id` string
    - `url` string, uri
    - `events` string[]
    - `header_names` string[]: Configured auth header names; values are never returned
    - `active` boolean
    - `created_at` string, date-time
  - `hint` string

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate limit exceeded - wait and retry

---

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