---
title: "Delete webhook subscription"
method: DELETE
path: "/v1/webhook_subscriptions/{id}"
tags: ["Webhook Subscriptions"]
---

# Delete webhook subscription

`DELETE /v1/webhook_subscriptions/{id}`

## Request

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

Permanently deletes a webhook subscription. This cannot be undone.

## Path parameters

- `id` string, uuid, required

## Response `200`

The deleted webhook subscription resource

- WebhookSubscriptionResourceDto
  - `id` string, required: Unique identifier of the webhook subscription.
  - `type` 'webhook_subscription', required: Resource type discriminator.
  - `url` string, required: The HTTPS URL where webhook events are delivered.
  - `events` string[], required: Event types this subscription receives.
  - `metadata` object, required: Set of up to 50 key-value string pairs you can attach to store structured information, such as correlating this resource with an object in your own system. Keys may be up to 40 characters and values up to 500 characters.
  - `created_at` string, date-time, required: ISO 8601 UTC timestamp when the subscription was created.
  - `updated_at` string, date-time, required: ISO 8601 UTC timestamp when the subscription was last updated.

## Changes

- **2026-10-16** `f7ded6c181ab`: 1 info
  - endpoint added
- **2026-07-29** `e5198bf3cf7e`: 2 warning
  - added the new `account_holder.active` enum value to the `events/items/` response property for the response status `200`
  - added the new `account_holder.closed` enum value to the `events/items/` response property for the response status `200`
- **2026-04-23** `f04b2c330a67`: 3 warning
  - added the new `conversion.completed` enum value to the `events/items/` response property for the response status `200`
  - added the new `conversion.created` enum value to the `events/items/` response property for the response status `200`
  - added the new `conversion.failed` enum value to the `events/items/` response property for the response status `200`
- **2026-04-21** `67983e71dc41`: 1 warning
  - added the new `deposit.received` enum value to the `events/items/` response property for the response status `200`
- **2026-04-15** `d91795c11a31`: 4 warning
  - added the new `return.failed` enum value to the `events/items/` response property for the response status `200`
  - added the new `return.initiated` enum value to the `events/items/` response property for the response status `200`
  - added the new `return.paid` enum value to the `events/items/` response property for the response status `200`
  - added the new `return.returned` enum value to the `events/items/` response property for the response status `200`

[Operation history](https://skmtc.dev/augustus/apis/ivy-api/changes/v1/webhook_subscriptions/:id/delete.md)

---

[API](https://skmtc.dev/augustus/apis/ivy-api.md) - [All operations](https://skmtc.dev/augustus/apis/ivy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/augustus/apis/ivy-api/revisions/e87bdcac11cc?raw)