---
title: "Update Webhook V2"
method: PUT
path: "/v2/webhook_v2/{id}"
tags: ["Webhook"]
---

# Update Webhook V2

`PUT /v2/webhook_v2/{id}`

# Update Webhook V2

Updates an existing v2 webhook.

Supports updating:
- event
- URL
- `args`
- headers
- active state

Use this endpoint to rotate shared secret or adjust event filter args over time.

## Path parameters

- `id` string, required

## Request body

- EditWebhookV2
  - `event` 'test' | 'event.catalog.item.add' | 'event.catalog.item.update' | 'event.catalog.item.delete' | 'event.catalog.item.table.row.add' | 'event.catalog.item.table.row.update' | 'event.catalog.item.table.row.delete' | 'event.catalog.custom' | 'event.contract.add' | 'event.contract.update' | 'event.contract.delete' | 'event.project.integration.start' | 'event.project.start' | 'event.project.finish' | 'event.project.approval.submitted' | 'event.project.step.status.change' | 'event.catalog.modification' | 'event.contact.info.upserted' | 'event.integration.status.updated' | 'event.catalog.vendor.manager.modified' | 'event.contract.details.upserted' | 'event.table.row.upserted' — An enumeration.
  - `url` string
  - `args` object
  - `headers` object
  - `entity_reference` string
  - `is_active` boolean

## Response `200`

Successful Response

- WebhookResponse
  - `id` string, required
  - `event` 'test' | 'event.catalog.item.add' | 'event.catalog.item.update' | 'event.catalog.item.delete' | 'event.catalog.item.table.row.add' | 'event.catalog.item.table.row.update' | 'event.catalog.item.table.row.delete' | 'event.catalog.custom' | 'event.contract.add' | 'event.contract.update' | 'event.contract.delete' | 'event.project.integration.start' | 'event.project.start' | 'event.project.finish' | 'event.project.approval.submitted' | 'event.project.step.status.change' | 'event.catalog.modification' | 'event.contact.info.upserted' | 'event.integration.status.updated' | 'event.catalog.vendor.manager.modified' | 'event.contract.details.upserted' | 'event.table.row.upserted', required — An enumeration.
  - `url` string, required
  - `args` object
  - `is_active` boolean
  - `fail_count` integer
  - `created_by_client_id` string

## Other responses

- `422` — Validation Error

---

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