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

# List webhooks

`GET /v1/webhooks`

## Request

- Base URL: `https://api.sonovault.now`
- URL: `https://api.sonovault.now/v1/webhooks`
- Auth: API key in header `x-api-key`

List your webhook endpoints. The signing secret is never returned after creation.

## Response `200`

Successful response

- object
  - `webhooks` Webhook[], required: Your webhook endpoints. `secret` is never included here, only in the create response.
    - `id` string, required: Webhook ID (UUID).
    - `url` string, required: Your HTTPS endpoint, where events are POSTed.
    - `description` string, nullable, required: Your label for the endpoint. `null` when you did not set one.
    - `event_types` string[], required: Which events this endpoint receives.
    - `enabled` boolean, required: `false` once you disable it, or after sustained delivery failures auto-disable it.
    - `secret` string: The signing secret for `Sonovault-Signature`. Returned **only** by `POST /v1/webhooks`, once. Store it then; it is never shown again.
    - `created_at` string, required: When the endpoint was registered, ISO-8601 UTC.
    - `last_delivery_at` string, nullable, required: Last delivery attempt, ISO-8601 UTC. `null` before the first one.

---

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