---
title: "Registrar un webhook endpoint"
method: POST
path: "/webhook_endpoints"
tags: ["webhookEndpoints"]
---

# Registrar un webhook endpoint

`POST /webhook_endpoints`

Registra una nueva URL para recibir notificaciones de webhook cuando ocurran eventos en tu cuenta. Con una llave TEST el endpoint se registra en el ambiente de prueba y solo recibe eventos simulados (`live_mode: false`); con una llave LIVE, en producción.

## Headers

- `X-SECRET-KEY` string, required

## Request body

- object
  - `url` string, uri, required — URL que recibirá las notificaciones de webhook
  - `description` string — (Opcional) Descripción del endpoint
  - `metadata` object — (Opcional) Metadata personalizada

## Response `201`

Webhook endpoint creado. El `signingSecret` solo se devuelve en esta
respuesta de creación; si lo pierdes, debes consultarlo en el dashboard de Svix.

- WebhookEndpointWithSecret
  - `id` string — ID del endpoint
  - `url` string, uri — URL que recibe los webhooks
  - `description` string — Descripción del endpoint
  - `disabled` boolean — Si el endpoint está deshabilitado
  - `metadata` object — Metadata personalizada
  - `createdAt` string, date-time — Fecha de creación
  - `updatedAt` string, date-time — Última actualización
  - `signingSecret` string — Secret para verificar las firmas de los webhooks. Solo se devuelve al crear el endpoint, no al listarlos.

---

[API](https://skmtc.dev/recurrente/apis/referencia-api.md) · [All operations](https://skmtc.dev/recurrente/apis/referencia-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recurrente/referencia-api/revisions/f494a078482c/schema)