---
title: "Update an existing webhook endpoint"
method: POST
path: "/webhooks/{webhookEndpointId}"
tags: ["Webhooks"]
---

# Update an existing webhook endpoint

`POST /webhooks/{webhookEndpointId}`

Update the configuration of an existing webhook endpoint. A webhook that has been disabled due to consecutive delivery failures can be reactivated by setting its status to 'active'.

## Path parameters

- `webhookEndpointId` string, uuid, required — ID for the webhook

## Request body

- UpdateWebhookParams — Request body for updating an existing webhook endpoint. All fields are optional - only provided fields will be updated.
  - `eventTypes` WebhookEventType[], nullable — Event types to subscribe to. Send null to subscribe to all event types. Send an array to subscribe to specific types. Omit to leave unchanged.
  - `filterPaths` ResourceField[], nullable — Resource field paths to filter events by. When specified, webhook events will only be sent when one of these fields changes. Send null for no filtering. Send an array to filter by specific fields. Omit to leave unchanged.
  - `status` 'active' | 'paused', nullable — Webhook status. Only 'active' and 'paused' values are allowed. Omit to leave unchanged.
  - `url` string, nullable — The URL to which webhook events will be delivered. Omit to leave unchanged.

## Response `200`

- ApiWebhookResponse — Webhook configuration details
  - `createdAt` string, yyyy-mm-ddThh:MM:ssZ, required — When the webhook was created
  - `eventTypes` WebhookEventType[], nullable — Optional array of event types this webhook is subscribed to. Nothing means all events.
  - `filterPaths` ResourceField[], nullable — Optional array of resource field paths to filter events by. Nothing means no filtering.
  - `id` string, uuid, required — Unique identifier for the webhook endpoint
  - `secret` string, nullable — Webhook signing secret. Only returned on creation (POST), not on GET or UPDATE operations.
  - `status` 'active' | 'paused' | 'disabled', required — Current status of the webhook (active, paused, or disabled)
  - `updatedAt` string, yyyy-mm-ddThh:MM:ssZ, required — When the webhook was last updated
  - `url` string, required — The URL that will receive webhook POST requests

## Other responses

- `400` — Invalid `body`
- `404` — `webhookEndpointId` not found

---

[API](https://skmtc.net/mercurytechnologies/apis/mercury-api.md) · [All operations](https://skmtc.net/mercurytechnologies/apis/mercury-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mercurytechnologies/mercury-api/revisions/0bdf4a496e03/schema)