---
title: "Update Webhook Endpoint"
method: PATCH
path: "/v3/webhooks/endpoints/{endpoint_id}"
tags: ["Webhooks"]
---

# Update Webhook Endpoint

`PATCH /v3/webhooks/endpoints/{endpoint_id}`

Updates the URL and/or subscribed event types for a webhook endpoint. The events array is fully replaced — include all types you want to keep.

## Path parameters

- `endpoint_id` string, required

## Request body

- UpdateWebhookEndpointRequest — Request body for PATCH /v3/webhooks/endpoints/{endpoint_id}.
  - `url` string, nullable — New URL for the endpoint. Must be publicly accessible HTTPS.
  - `events` WebhookEventType[], nullable — New list of event types to subscribe to. Replaces the existing list.

## Response `200`

Successful response

- object
  - `data` WebhookEndpointResponse — A registered webhook endpoint.
    - `endpoint_id` string, required — Unique identifier for this webhook endpoint.
    - `url` string, required — The URL that receives webhook POST requests.
    - `events` string[], nullable — Event types this endpoint subscribes to. Null means all events.
    - `status` string, required — Endpoint status: 'enabled' or 'disabled'.
    - `created_at` string, required — ISO 8601 timestamp when the endpoint was created.
    - `secret` string, nullable — The signing secret for verifying webhook payloads. Only returned on create and rotate-secret.

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication failed
- `404` — Resource not found
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/heygen/apis/heygen-external-api.md) · [All operations](https://skmtc.net/heygen/apis/heygen-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/heygen/heygen-external-api/versions/e2e54726e210/schema)