---
title: "Delete a webhook endpoint"
method: DELETE
path: "/v1/webhook_endpoints/{webhook_endpoint}"
---

# Delete a webhook endpoint

`DELETE /v1/webhook_endpoints/{webhook_endpoint}`

You can also delete webhook endpoints via the [webhook endpoint management](https://dashboard.stripe.com/account/webhooks) page of the Stripe dashboard.

## Path parameters

- `webhook_endpoint` string, required

## Response `200`

Successful response.

- DeletedWebhookEndpoint
  - `deleted` true, required — Always true for a deleted object
  - `id` string, required — Unique identifier for the object.
  - `object` 'webhook_endpoint', required — String representing the object's type. Objects of the same type share the same value.

## Other responses

- `default` — Error response.

## Changes

> 18 revisions in range; 2 not diffed, 1 could not be searched.

- **2025-02-14** `1199cc3c5574` — 2 breaking, 9 info
  - the response property `error/payment_intent/invoice/anyOf[subschema #2: Invoice]/lines/data/items/pretax_credit_amounts/items/credit_balance_transaction/anyOf[subschema #2: CreditBalanceTransaction]/credit_grant/anyOf[subschema #2: CreditGrant]/applicability_config/scope/price_type` became optional for the status `default`
  - the response property `error/payment_intent/invoice/anyOf[subschema #2: Invoice]/total_pretax_credit_amounts/items/credit_balance_transaction/anyOf[subschema #2: CreditBalanceTransaction]/credit_grant/anyOf[subschema #2: CreditGrant]/applicability_config/scope/price_type` became optional for the status `default`
  - added the optional property `error/payment_intent/invoice/anyOf[subschema #2: Invoice]/lines/data/items/pretax_credit_amounts/items/credit_balance_transaction/anyOf[subschema #2: CreditBalanceTransaction]/credit_grant/anyOf[subschema #2: CreditGrant]/applicability_config/scope/prices` to the response with the `default` status
  - added the optional property `error/payment_intent/invoice/anyOf[subschema #2: Invoice]/lines/data/items/pretax_credit_amounts/items/credit_balance_transaction/anyOf[subschema #2: CreditBalanceTransaction]/credit_grant/anyOf[subschema #2: CreditGrant]/priority` to the response with the `default` status
  - …7 more
- …earlier changes not shown

[Full history](https://skmtc.dev/stripe/apis/spec3/changes/v1/webhook_endpoints/:webhook_endpoint/delete.md)

---

[API](https://skmtc.dev/stripe/apis/spec3.md) · [All operations](https://skmtc.dev/stripe/apis/spec3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stripe/spec3/revisions/2df8ec106d35/schema)