> ## Documentation Index
> Fetch the complete documentation index at: https://docs.piriod.com/llms.txt
> Use this file to discover all available pages before exploring further.

#  Registrar un webhook

> Registra la URL del endpoint de tu servicio en Piriod, selecciona los eventos a los que deseas suscribirlo y gestiona su activación, desactivación o eliminación desde el dashboard.

Tras crear el endpoint del webhook en tu servicio, debes registrarlo en Piriod para que la plataforma sepa dónde enviar las notificaciones de eventos. El registro solo tarda unos segundos desde el dashboard de Piriod.

## Agrega el endpoint del webhook en tu organización

<Steps>
  <Step title="Abrir configuración de Webhooks">
    En tu dashboard de Piriod, ve a **Configuración de la organización → Webhooks**.
  </Step>

  <Step title="Crear un nuevo webhook">
    Click **+ Nuevo webhook** para abrir la configuración de registro.
  </Step>

  <Step title="Rellena los detalles">
    Complete los siguientes campos:

    * **URL** - ingresa la URL de tu endpoint. Debes usar HTTPS.
    * **Descripción** - texto opcional para identificar este endpoint.
    * **Eventos** - selecciona los eventos que deseas que activen este webhook.
  </Step>

  <Step title="Guardar">
    Haz clic en **Crear webhook** para finalizar el registro. Piriod comenzará a enviar eventos coincidentes a tu endpoint inmediatamente.
  </Step>
</Steps>

## Administrar el webhook

Desde la vista de detalles del webhook puedes:

* **Deshabilitar** - pausar la entrega de mensajes sin eliminar el endpoint. No se envían eventos mientras esté deshabilitado.
* **Habilitar** - reanudar la entrega después de la desactivación.
* **Eliminar** - eliminar permanentemente el endpoint.

<Note>
  Si tu endpoint devuelve respuestas distintas de 2xx **tres veces seguidas**, Piriod lo desactiva automáticamente. Vuelve a activarlo desde esta misma vista de detalles una vez que se haya resuelto el problema.
</Note>