---
title: "Register a webhook subscription"
method: POST
path: "/v1/webhooks/"
tags: ["/v1/webhook"]
---

# Register a webhook subscription

`POST /v1/webhooks/`

## Request

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

Register a webhook subscription to receive events from Counsel.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `name` string, nullable, required
  - `destination` string, starts_with, required

## Response `200`

Default Response

- object
  - `id` string, uuid, required

## Other responses

- `400`: 400 error with a machine-readable `code` for client branching.
- `401`: Standard error body returned for non-2xx responses.
- `403`: Standard error body returned for non-2xx responses.
- `404`: Standard error body returned for non-2xx responses.
- `409`: Standard error body returned for non-2xx responses.
- `413`: Standard error body returned for non-2xx responses.
- `429`: Standard error body returned for non-2xx responses.
- `500`: Standard error body returned for non-2xx responses.
- `502`: Default Response
- `503`: Default Response
- `504`: Default Response

---

[API](https://skmtc.dev/counselhealth/apis/counsel-api.md) - [All operations](https://skmtc.dev/counselhealth/apis/counsel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/counselhealth/apis/counsel-api/revisions/4110a89127e8?raw)