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

# Obtener Webhook Endpoint

`GET /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`

Devuelve la configuración de un webhook endpoint de la organización autenticada.

Incluye los eventos habilitados, el estado, la versión y los nombres de los encabezados personalizados; los valores de esos encabezados nunca se exponen.

## Path parameters

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

## 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

- `401`: Faltan las credenciales o son inválidas.
- `403`: No tienes acceso a este recurso.
- `404`: El recurso solicitado no existe.
- `422`: El cuerpo de la petición no pasó la validación.
- `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)