Saltar al contenido principal
DELETE
Eliminar un webhook
Elimina un webhook. Yuno deja de enviar notificaciones a su url y devuelve el webhook que eliminó, para que conserves un registro de los eventos a los que estaba suscrito. Para detener las notificaciones y conservar la configuración, define state como INACTIVE con Actualizar un webhook en su lugar.

Autorizaciones

public-api-key
string
header
predeterminado:<Your public-api-key>
requerido
private-secret-key
string
header
predeterminado:<Your private-secret-key>
requerido

Parámetros de ruta

webhook_id
string
requerido

El identificador único del webhook, tal como lo devuelve Listar webhooks.

Ejemplo:

"12345"

Parámetros de consulta

account_id
string<uuid>
requerido

El identificador único de la cuenta a la que pertenece el webhook.

Ejemplo:

"493e9374-510a-4201-9e09-de669d75f256"

Respuesta

El webhook que eliminaste.

id
string

El identificador único del webhook.

Ejemplo:

"12345"

account_id
string<uuid>

El identificador único de la cuenta a la que pertenece el webhook.

Ejemplo:

"493e9374-510a-4201-9e09-de669d75f256"

name
string

Tu nombre para el webhook.

Ejemplo:

"Production payments listener"

state
enum<string>

Los webhooks ACTIVE reciben notificaciones, los INACTIVE no. Un webhook empieza como ACTIVE.

Opciones disponibles:
ACTIVE,
INACTIVE
Ejemplo:

"ACTIVE"

url
string

El endpoint al que Yuno envía las notificaciones.

Ejemplo:

"https://api.acme.com/yuno/webhooks"

api_key
string | null

Enmascarado como ***, o null cuando no lo has configurado.

Ejemplo:

"***"

secret
string | null

Enmascarado como ***, o null cuando no lo has configurado.

Ejemplo:

"***"

hmac_client_secret
string | null

Enmascarado como ***, o null cuando no lo has configurado.

Ejemplo:

"***"

oauth2_authentication_url
string | null

Tu endpoint de token.

Ejemplo:

"https://api.acme.com/oauth/token"

oauth2_client_secret
string | null

Enmascarado como ***, o null cuando no lo has configurado.

Ejemplo:

"***"

oauth2_client_id
string | null

El identificador de cliente con el que Yuno se autentica.

Ejemplo:

"acme_client_id"

oauth2_grant_type
string | null

El tipo de concesión con el que Yuno solicita el token.

Ejemplo:

"client_credentials"

oauth2_scope
string | null

El alcance con el que Yuno solicita el token.

Ejemplo:

"webhooks:write"

oauth2_authorization_name
string | null

El encabezado en el que Yuno envía el token.

Ejemplo:

"Authorization"

oauth2_include_client_id
boolean

Indica si Yuno también envía el identificador de cliente como encabezado en la solicitud del token.

Ejemplo:

true

enrollment_triggers
string[] | null

Los eventos de inscripción a los que se suscribe el webhook.

Ejemplo:
payment_triggers
string[] | null

Los eventos de pago a los que se suscribe el webhook.

Ejemplo:
report_triggers
string[] | null

Los eventos de reportes a los que se suscribe el webhook.

Ejemplo:
subscription_triggers
string[] | null

Los eventos de suscripción a los que se suscribe el webhook.

Ejemplo:
onboarding_triggers
string[] | null

Los eventos de onboarding a los que se suscribe el webhook.

Ejemplo:
renewal_days
integer | null

Cuántos días antes de una renovación Yuno envía la notificación CLOSE_TO_RENEWAL.

Ejemplo:

5

created_at
string<date-time>

La fecha y hora en que se creó el webhook, en ISO 8601.

Ejemplo:

"2026-07-09T13:05:36.482913Z"

updated_at
string<date-time>

La fecha y hora de la última actualización del webhook, en ISO 8601. Coincide con created_at hasta que actualizas el webhook por primera vez.

Ejemplo:

"2026-07-11T16:20:44.918330Z"