---
title: "One delivery webhook, with health"
method: GET
path: "/v1/webhooks/{id}"
tags: ["Delivery webhooks"]
---

# One delivery webhook, with health

`GET /v1/webhooks/{id}`

## Request

- Base URL: `https://api.cadencercs.com`
- URL: `https://api.cadencercs.com/v1/webhooks/{id}`
- Auth: HTTP bearer

`health.consecutiveFailures` counts events that exhausted every retry, not attempts.

## Path parameters

- `id` string, required

## Response `200`

The endpoint.

- DeliveryWebhook: An endpoint **we POST to** when something happens on your conversations. The opposite direction from `PUT /v1/agents/{id}/webhook`, which points *Google* somewhere other than Cadence.
  - `id` string, required
  - `url` string, required: Your https:// endpoint.
  - `events` string[], required
  - `brandId` string, nullable: Null means every brand on the account.
  - `description` string, nullable
  - `active` boolean, required: False once disabled, whether by you or by repeated failure.
  - `health` object
    - `lastSuccessAt` string, nullable
    - `lastFailureAt` string, nullable
    - `lastError` string, nullable
    - `consecutiveFailures` number: Consecutive *events* that failed every retry — not attempts. One slow afternoon does not count.
    - `disabledAt` string, nullable
    - `disabledReason` string, nullable
  - `createdAt` string

## Other responses

- `401`: Not signed in, and no account-linked API key was sent.
- `404`: No such webhook on this account.
- `500`: Unexpected server error. The body is always JSON.

---

[API](https://skmtc.dev/cadencercs/apis/cadence-api.md) · [All operations](https://skmtc.dev/cadencercs/apis/cadence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cadencercs/apis/cadence-api/revisions/9438443c2081?raw)