---
title: "Editar Webhook Endpoint"
method: PUT
path: "/webhook_endpoints/{webhook_endpoint_id}"
tags: ["Webhook Endpoints"]
---

# Editar Webhook Endpoint

`PUT /webhook_endpoints/{webhook_endpoint_id}`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/webhook_endpoints/{webhook_endpoint_id}`
- Auth: API key in header `x-api-key`

Actualiza la configuración de un webhook endpoint existente de la organización.

Solo modifica los campos incluidos en la solicitud; el resto conserva su valor actual. Si cambia la URL o los eventos, ningún otro endpoint de la URL resultante puede recibir uno de esos eventos. Devuelve el endpoint ya actualizado.

## Path parameters

- `webhook_endpoint_id` string, required: Identificador del Webhook Endpoint.

## Request body

- UpdateWebhookEndpointPayload: Webhook Endpoint model for update. Fields are set optional and with None default value.
  - `custom_headers` object
  - `enabled_events` string[]: Eventos a los que se suscribe este endpoint. El nombre es siempre `recurso.evento`: los que terminan en `.status_update` avisan cualquier cambio de estado del recurso y los específicos, como [`invoice.paid`](/reference/invoice-paid), una transición concreta; los que llevan `bulk` resumen una operación masiva en un solo envío en lugar de uno por registro. Declara solo los que tu integración procesa: suscribirse a la lista completa no es lo esperable. Los eventos deprecados no se pueden declarar; un endpoint que ya los tenía los sigue recibiendo, pero mientras los conserve no admite cambios de eventos, URL ni estado.
  - `status` 'enabled' | 'disabled': Si el Webhook Endpoint está recibiendo eventos. Un endpoint nace `enabled`, y ese es el único estado en que Toku le entrega los eventos a los que está suscrito. Pasarlo a `disabled` lo deja registrado con su configuración intacta, pero además de cortar las entregas nuevas abandona las que estaban pendientes de reintento: no se acumulan para enviarlas al volver a habilitarlo.
  - `url` string, uri
  - `webhook_version` string, date

## Response `200`

Successful Response

- WebhookEndpoint: Destino al que Toku entrega los webhooks. Los endpoints se registran por organización, no por Customer: cada evento se entrega a todos los endpoints que estén habilitados y suscritos a ese tipo de evento, de modo que varios pueden recibir el mismo aviso.
  - `custom_headers_keys` string[]: Nombres de los encabezados personalizados configurados; sus valores nunca se exponen.
  - `enabled_events` string[], required: Tipos de evento que este endpoint recibe. El nombre es siempre `recurso.evento`: los que terminan en `.status_update` avisan cualquier cambio de estado del recurso y los específicos, como [`invoice.paid`](/reference/invoice-paid), una transición concreta; los que llevan `bulk` resumen una operación masiva en un solo envío en lugar de uno por registro.
  - `id` string, required: Identificador del Webhook Endpoint.
  - `secret` string, required: Secreto compartido con el que se firman los envíos para verificar su origen.
  - `status` 'enabled' | 'disabled': Si el Webhook Endpoint está recibiendo eventos. Un endpoint nace `enabled`, y ese es el único estado en que Toku le entrega los eventos a los que está suscrito. Pasarlo a `disabled` lo deja registrado con su configuración intacta, pero además de cortar las entregas nuevas abandona las que estaban pendientes de reintento: no se acumulan para enviarlas al volver a habilitarlo.
  - `url` string, uri, required: URL de destino a la que se entregan los webhooks.
  - `webhook_version` string, date: Versión del contrato de payload que usa el endpoint.

## Other responses

- `400`: Evento deprecado no permitido o forma inválida de `filter_dimensions`.
- `401`: Faltan las credenciales o son inválidas.
- `403`: No tienes acceso a este recurso.
- `404`: El recurso solicitado no existe.
- `409`: Otro webhook endpoint de la organización en la misma URL ya recibe alguno de los eventos. La respuesta indica su ID y los eventos compartidos.
- `422`: Payload inválido, dimensión de filtro no aceptada, más de un evento habilitado, evento oculto en un endpoint público, o un cambio de eventos o de versión que el filtro configurado por Toku para el endpoint no admite.
- `429`: Se superó el límite de peticiones permitidas.

---

[API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)