Saltar al contenido principal
PATCH
Actualizar un webhook
Actualiza un webhook. Envía account_id y los campos que quieres cambiar. Úsalo para apuntar un webhook a una nueva url, cambiar los eventos que recibe, rotar las credenciales con las que Yuno realiza las entregas o desactivarlo. state activa y desactiva las entregas: INACTIVE las detiene y conserva la configuración, y ACTIVE las reanuda. Un api_key, secret o hmac_client_secret rotado se aplica a la siguiente entrega. Para eliminar renewal_days, envía clear_renewal_days como true por sí solo.
Los campos de activadores se reemplazan, no se combinan. Envía la lista completa de eventos a los que quieres que esté suscrito el webhook, y omite el campo para dejarlo como está.
Los campos de OAuth2 se configuran como un conjunto: cuando cambies cualquiera de oauth2_authentication_url, oauth2_client_id, oauth2_client_secret o oauth2_grant_type, envía los cuatro. Renombrar un webhook con un name que la cuenta ya usa, o moverlo a una url donde otro webhook escucha alguno de los mismos eventos, devuelve 409 WEBHOOK_ALREADY_EXISTS.

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 Crear un webhook.

Ejemplo:

"12345"

Cuerpo

application/json
account_id
string<uuid>
requerido

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. Debe ser único dentro de la cuenta.

Ejemplo:

"Production payments listener"

state
enum<string>

Defínelo en INACTIVE para detener las entregas conservando la configuración, y de nuevo en ACTIVE para reanudarlas.

Opciones disponibles:
ACTIVE,
INACTIVE
Ejemplo:

"INACTIVE"

url
string

El endpoint al que Yuno envía las notificaciones. Debe ser una URL http o https que se resuelva a una dirección pública y enrutable.

Ejemplo:

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

api_key
string

Reemplaza el x-api-key que Yuno envía en cada entrega.

Ejemplo:

"my-webhook-key-v2"

secret
string

Reemplaza el x-secret que Yuno envía en cada entrega.

Ejemplo:

"my-rotated-secret"

hmac_client_secret
string

Reemplaza la clave con la que Yuno firma el payload.

Ejemplo:

"my-rotated-hmac-secret"

oauth2_authentication_url
string

Tu endpoint de token. Debe usar HTTPS. Envía oauth2_authentication_url, oauth2_client_id, oauth2_client_secret y oauth2_grant_type juntos.

Ejemplo:

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

oauth2_client_id
string

El identificador de cliente con el que Yuno se autentica. Envía oauth2_authentication_url, oauth2_client_id, oauth2_client_secret y oauth2_grant_type juntos.

Ejemplo:

"acme_client_id"

oauth2_client_secret
string

El secreto de cliente con el que Yuno se autentica. Envía oauth2_authentication_url, oauth2_client_id, oauth2_client_secret y oauth2_grant_type juntos.

Ejemplo:

"acme_client_secret"

oauth2_grant_type
string

El tipo de concesión con el que Yuno solicita el token. Envía oauth2_authentication_url, oauth2_client_id, oauth2_client_secret y oauth2_grant_type juntos.

Ejemplo:

"client_credentials"

oauth2_scope
string

El alcance con el que Yuno solicita el token.

Ejemplo:

"webhooks:write"

oauth2_authorization_name
string

El encabezado en el que Yuno envía el token. Por defecto es Authorization.

Ejemplo:

"Authorization"

oauth2_include_client_id
boolean

Envía también el identificador de cliente como encabezado en la solicitud del token.

Ejemplo:

true

enrollment_triggers
enum<string>[]

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

Opciones disponibles:
ENROLL,
UNENROLL
Ejemplo:
payment_triggers
enum<string>[]

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

Opciones disponibles:
AUTHORIZE,
CANCEL,
CAPTURE,
CHARGEBACK,
PRECHARGEBACK,
PURCHASE,
REFUND,
SPLIT_UPDATE,
VERIFY
Ejemplo:
report_triggers
enum<string>[]

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

Opciones disponibles:
CREATE,
UPDATE
Ejemplo:
subscription_triggers
enum<string>[]

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

Opciones disponibles:
ACTIVE,
CANCEL,
CLOSE_TO_RENEWAL,
COMPLETE,
CREATE,
CREATION_FAILED,
PAUSE,
PLAN_CHANGE_CANCELED,
PLAN_CHANGE_SCHEDULED,
PLAN_CHANGED,
PROMOTION_APPLIED,
RESUME
Ejemplo:
onboarding_triggers
enum<string>[]

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

Opciones disponibles:
BLOCKED,
CANCELLED,
CREATED,
DECLINED,
ERROR,
EXPIRED,
INACTIVE,
PENDING,
SUCCEEDED,
TRANSFERRED,
UNBLOCKED
Ejemplo:
renewal_days
integer

Cuántos días antes de una renovación Yuno envía la notificación CLOSE_TO_RENEWAL. Debe ser 1 o más. Envíalo solo, no junto con clear_renewal_days.

Ejemplo:

5

clear_renewal_days
boolean

Defínelo en true para quitar renewal_days. Envíalo solo, no junto con renewal_days.

Ejemplo:

true

Respuesta

El webhook actualizado.

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"