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

# Update webhook subscription

`POST /v1/webhook_subscriptions/{id}`

## Request

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

Updates the URL and/or subscribed events.

## Path parameters

- `id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- UpdateWebhookSubscriptionBodyDto
  - `url` string, uri, nullable: The new HTTPS URL. Omit or send null to keep the current URL.
  - `events` string[], nullable: New event types. Omit or send null to keep the current events. Use ["*"] for all events.

## Response `200`

Success

- 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-08-27** `8e304f78f67e`: 2 info
  - the request property `events` became optional
  - the request property `url` became optional
- **2026-08-21** `79d607871de9`: 2 breaking, 2 info
  - the request property `events` became required
  - the request property `url` became required
  - the request property `events` became nullable
  - the request property `url` became nullable
- **2026-08-19** `3d21138daf4c`: 1 breaking
  - added the pattern `^https:\/\/.*` to the request property `url`
- **2026-07-29** `e5198bf3cf7e`: 2 warning, 2 info
  - 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`
  - added the new `account_holder.active` enum value to the request property `events/items/`
  - added the new `account_holder.closed` enum value to the request property `events/items/`

[Operation history](https://skmtc.dev/augustus/apis/ivy-api/changes/v1/webhook_subscriptions/:id/post.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)