---
title: "List webhooks"
method: GET
path: "/api/public/v1/webhooks"
tags: ["Public API v1 — Webhooks", "Public API v1 — Webhooks"]
---

# List webhooks

`GET /api/public/v1/webhooks`

## Request

- Base URL: `https://api.thebetterhire.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.thebetterhire.ai/api/public/v1/webhooks`
- Auth: HTTP bearer

List all registered webhook endpoints for your organization.

## Response `200`

Successful Response

- WebhookListResponse: List of registered webhooks.
  - `webhooks` WebhookResponse[], required: Registered webhook endpoints.
    - `id` string, required: Webhook ID.
    - `url` string, required: Webhook URL.
    - `events` string[], required: Subscribed event types.
    - `enabled` boolean, required: Whether this webhook is active.
    - `description` string, nullable
    - `secret` string, nullable: Signing secret (only returned on creation). Use to verify HMAC-SHA256 signature in X-BetterHire-Signature header.
    - `created_at` string, required: ISO 8601 creation timestamp.

---

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