---
title: "Update a Webhook"
method: PATCH
path: "/webhooks/{id}"
tags: ["Webhooks"]
---

# Update a Webhook

`PATCH /webhooks/{id}`

Update the data associated with a specific webhook. 

**OAuth Scope required:** `public.webhooks.updateWebhooks`

## Path parameters

- `id` string, required

## Headers

- `x-as-user-email` string
- `x-as-user-id` string

## Request body

- object
  - `events` WebhookEvent[] — The type of events that will trigger a notification to the target URL.
  - `targetURL` string, https-url — The URL of where the notification gets sent.
  - `status` 'enabled' | 'disabled' — The status of the webhook. If the status is `disabled`, the webhook will not be triggered.

## Response `200`

200

- WebhookModel — Webhook object describing the subscribed events and target URL to be called.
  - `id` string, required — Unique ID of the webhook
  - `events` WebhookEvent[], required — Array of events to which webhook is subscribed to.
  - `targetURL` string, https-url, required — Target URL to which the webhook is called.
  - `companyId` string, required — Unique ID of the Ironclad company instance to which the webhook belongs to.
  - `status` 'enabled' | 'disabled' | 'disabledBySystem', required — The status of the webhook. If the status is `disabled`, the webhook will not be triggered.
  - `statusLastUpdatedAt` string, date-time — The timestamp of the most recent status change in ISO 8601 format.
  - `statusLastUpdatedBy` string — The user or system ID that made the most recent status change.
  - `consecutiveFailureCount` number, required — The number of consecutive failed deliveries of the webhook. After a certain number of consecutive failures over a certain period of time, the webhook will be disabled. See [more](https://developer.ironcladapp.com/reference/webhook-deactivation).
  - `firstConsecutiveFailure` string, date-time — The timestamp of the first consecutive failure of the webhook in ISO 8601 format.

## Other responses

- `400` — 400

---

[API](https://skmtc.net/ironcladapp/apis/ironclad-public-api.md) · [All operations](https://skmtc.net/ironcladapp/apis/ironclad-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ironcladapp/ironclad-public-api/versions/9459b4cfc1e0/schema)