---
title: "Update Webhook Endpoint"
method: POST
path: "/webhook_endpoints/{webhook_endpoint_id}"
---

# Update Webhook Endpoint

`POST /webhook_endpoints/{webhook_endpoint_id}`

Updates a webhook endpoint for the authenticated project.

## Path parameters

- `webhook_endpoint_id` string, required

## Request body

- PublicUpdateEndpointBody
  - `name` string — A new human-readable name for the webhook endpoint.
  - `url` string — A new HTTPS URL that receives webhook deliveries.
  - `event_types` ProjectEventTypeEnum[] — The complete set of event types that should trigger deliveries.

## Response `200`

Success

- WebhookEndpointBody
  - `id` string, required — The unique ID of the webhook endpoint.
  - `object` 'webhook_endpoint', required — The object type, which is always webhook_endpoint.
  - `created_at` integer, required — The Unix timestamp when the endpoint was created.
  - `updated_at` integer — The Unix timestamp of the last endpoint configuration or signing-secret change. Initialized at creation; tests and unchanged updates do not advance it.
  - `name` string, required — The human-readable name of the endpoint.
  - `url` string, required — The HTTPS URL that receives webhook deliveries.
  - `event_types` string[], required — The event types that trigger deliveries to this endpoint.
  - `signing_secret_hint` string, nullable, required — A masked hint for the endpoint's signing secret.

## Other responses

- `400` — The webhook endpoint parameters are invalid or the requested URL or event types are not permitted.
- `404` — The webhook endpoint was not found in the authenticated project.

## Changes

- **2026-09-25** `d86203de41ae` — 2 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `404`
- **2026-09-16** `c8bd56db4095` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/openai/apis/openapi/changes/webhook_endpoints/:webhook_endpoint_id/post.md)

---

[API](https://skmtc.dev/openai/apis/openapi.md) · [All operations](https://skmtc.dev/openai/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc.dev/openai/apis/openapi/revisions/4b75527da17b?raw)