---
title: "Delete a Webhook"
method: DELETE
path: "/webhooks/{webhook_id}"
---

# Delete a Webhook

`DELETE /webhooks/{webhook_id}`

Deletes a webhook. Yuno stops sending notifications to its URL, and returns the webhook it deleted.

## Path parameters

- `webhook_id` string, required

## Query parameters

- `account_id` string, uuid, required

## Response `200`

The webhook you deleted.

- Webhook
  - `id` string — The unique identifier of the webhook.
  - `account_id` string, uuid — The unique identifier of the account the webhook belongs to.
  - `name` string — Your name for the webhook.
  - `state` 'ACTIVE' | 'INACTIVE' — `ACTIVE` webhooks receive notifications, `INACTIVE` ones do not. A webhook starts out `ACTIVE`.
  - `url` string — The endpoint Yuno sends the notifications to.
  - `api_key` string — Masked as `***`, or `null` when you have not configured it.
  - `secret` string — Masked as `***`, or `null` when you have not configured it.
  - `hmac_client_secret` string — Masked as `***`, or `null` when you have not configured it.
  - `oauth2_authentication_url` string — Your token endpoint.
  - `oauth2_client_secret` string — Masked as `***`, or `null` when you have not configured it.
  - `oauth2_client_id` string — The client identifier Yuno authenticates with.
  - `oauth2_grant_type` string — The grant type Yuno requests the token with.
  - `oauth2_scope` string — The scope Yuno requests the token with.
  - `oauth2_authorization_name` string — The header Yuno sends the token in.
  - `oauth2_include_client_id` boolean — Whether Yuno also sends the client identifier as a header on the token request.
  - `enrollment_triggers` string[] — The enrollment events the webhook subscribes to.
  - `payment_triggers` string[] — The payment events the webhook subscribes to.
  - `report_triggers` string[] — The report events the webhook subscribes to.
  - `subscription_triggers` string[] — The subscription events the webhook subscribes to.
  - `onboarding_triggers` string[] — The onboarding events the webhook subscribes to.
  - `renewal_days` unknown
  - `created_at` string, date-time — The date and time the webhook was created, in ISO 8601.
  - `updated_at` string, date-time — The date and time the webhook was last updated, in ISO 8601. It matches `created_at` until you update the webhook for the first time.

## Other responses

- `400` — The `account_id` is missing or invalid.
- `401` — Your API credentials are missing or invalid.
- `404` — There is no webhook with that identifier on the account.
- `502` — The webhook service is temporarily unavailable.

---

[API](https://skmtc.net/y/apis/ai-caller.md) · [All operations](https://skmtc.net/y/apis/ai-caller/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/y/ai-caller/revisions/05b629819b49/schema)