Update a Webhook
Updates a webhook, including its state and the credentials Yuno delivers with
account_id and the fields you want to change. Use it to point a webhook at a new url, change the events it receives, rotate the credentials Yuno delivers with, or deactivate it.
state turns deliveries on and off: INACTIVE stops them and keeps the configuration, and ACTIVE resumes them. A rotated api_key, secret or hmac_client_secret applies to the next delivery. To remove renewal_days, send clear_renewal_days as true on its own.
oauth2_authentication_url, oauth2_client_id, oauth2_client_secret or oauth2_grant_type, send the four of them.
Renaming a webhook to a name the account already uses, or moving it onto a url where another webhook listens to one of the same events, returns 409 WEBHOOK_ALREADY_EXISTS.Authorizations
Path Parameters
The unique identifier of the webhook, as returned by Create a Webhook.
"12345"
Body
The unique identifier of the account the webhook belongs to.
"493e9374-510a-4201-9e09-de669d75f256"
Your name for the webhook. It must be unique within the account.
"Production payments listener"
Set it to INACTIVE to stop the deliveries while keeping the configuration, and back to ACTIVE to resume them.
ACTIVE, INACTIVE "INACTIVE"
The endpoint Yuno sends the notifications to. It must be an http or https URL that resolves to a public, routable address.
"https://api.acme.com/yuno/webhooks"
Replaces the x-api-key Yuno sends on every delivery.
"my-webhook-key-v2"
Replaces the x-secret Yuno sends on every delivery.
"my-rotated-secret"
Replaces the key Yuno signs the payload with.
"my-rotated-hmac-secret"
Your token endpoint. It must use HTTPS. Send oauth2_authentication_url, oauth2_client_id, oauth2_client_secret and oauth2_grant_type together.
"https://api.acme.com/oauth/token"
The client identifier Yuno authenticates with. Send oauth2_authentication_url, oauth2_client_id, oauth2_client_secret and oauth2_grant_type together.
"acme_client_id"
The client secret Yuno authenticates with. Send oauth2_authentication_url, oauth2_client_id, oauth2_client_secret and oauth2_grant_type together.
"acme_client_secret"
The grant type Yuno requests the token with. Send oauth2_authentication_url, oauth2_client_id, oauth2_client_secret and oauth2_grant_type together.
"client_credentials"
The scope Yuno requests the token with.
"webhooks:write"
The header Yuno sends the token in. Defaults to Authorization.
"Authorization"
Send the client identifier as a header on the token request as well.
true
Replaces the enrollment events the webhook subscribes to.
ENROLL, UNENROLL Replaces the payment events the webhook subscribes to.
AUTHORIZE, CANCEL, CAPTURE, CHARGEBACK, PRECHARGEBACK, PURCHASE, REFUND, VERIFY Replaces the report events the webhook subscribes to.
CREATE, UPDATE Replaces the subscription events the webhook subscribes to.
ACTIVE, CANCEL, CLOSE_TO_RENEWAL, COMPLETE, CREATE, PAUSE, RESUME Replaces the onboarding events the webhook subscribes to.
BLOCKED, CANCELLED, CREATED, DECLINED, ERROR, EXPIRED, INACTIVE, PENDING, SUCCEEDED, TRANSFERRED, UNBLOCKED How many days before a renewal Yuno sends the CLOSE_TO_RENEWAL notification. It must be 1 or more. Send it on its own, not together with clear_renewal_days.
5
Set it to true to remove renewal_days. Send it on its own, not together with renewal_days.
true
Response
The updated webhook.
The unique identifier of the webhook.
"12345"
The unique identifier of the account the webhook belongs to.
"493e9374-510a-4201-9e09-de669d75f256"
Your name for the webhook.
"Production payments listener"
ACTIVE webhooks receive notifications, INACTIVE ones do not. A webhook starts out ACTIVE.
ACTIVE, INACTIVE "ACTIVE"
The endpoint Yuno sends the notifications to.
"https://api.acme.com/yuno/webhooks"
Masked as ***, or null when you have not configured it.
"***"
Masked as ***, or null when you have not configured it.
"***"
Masked as ***, or null when you have not configured it.
"***"
Your token endpoint.
"https://api.acme.com/oauth/token"
Masked as ***, or null when you have not configured it.
"***"
The client identifier Yuno authenticates with.
"acme_client_id"
The grant type Yuno requests the token with.
"client_credentials"
The scope Yuno requests the token with.
"webhooks:write"
The header Yuno sends the token in.
"Authorization"
Whether Yuno also sends the client identifier as a header on the token request.
true
The enrollment events the webhook subscribes to.
The payment events the webhook subscribes to.
The report events the webhook subscribes to.
The subscription events the webhook subscribes to.
The onboarding events the webhook subscribes to.
How many days before a renewal Yuno sends the CLOSE_TO_RENEWAL notification.
5
The date and time the webhook was created, in ISO 8601.
"2026-07-09T13:05:36.482913Z"
The date and time the webhook was last updated, in ISO 8601. It matches created_at until you update the webhook for the first time.
"2026-07-11T16:20:44.918330Z"