Skip to main content
GET
List Webhooks
Lists the webhooks configured on an account, with their secrets masked. An account with no webhooks returns an empty array. Pass state=ACTIVE or state=INACTIVE to list only the webhooks in that state, and omit it to list all of them. The same webhooks are listed in the Developers tab of the Yuno dashboard.

Authorizations

public-api-key
string
header
default:<Your public-api-key>
required
private-secret-key
string
header
default:<Your private-secret-key>
required

Query Parameters

account_id
string<uuid>
required

The unique identifier of the account the webhooks belong to.

Example:

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

state
enum<string>

Return only the webhooks in this state. Omit it to return all of them.

Available options:
ACTIVE,
INACTIVE
Example:

"ACTIVE"

Response

The webhooks configured on the account, or an empty array if it has none.

id
string

The unique identifier of the webhook.

Example:

"12345"

account_id
string<uuid>

The unique identifier of the account the webhook belongs to.

Example:

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

name
string

Your name for the webhook.

Example:

"Production payments listener"

state
enum<string>

ACTIVE webhooks receive notifications, INACTIVE ones do not. A webhook starts out ACTIVE.

Available options:
ACTIVE,
INACTIVE
Example:

"ACTIVE"

url
string

The endpoint Yuno sends the notifications to.

Example:

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

api_key
string | null

Masked as ***, or null when you have not configured it.

Example:

"***"

secret
string | null

Masked as ***, or null when you have not configured it.

Example:

"***"

hmac_client_secret
string | null

Masked as ***, or null when you have not configured it.

Example:

"***"

oauth2_authentication_url
string | null

Your token endpoint.

Example:

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

oauth2_client_secret
string | null

Masked as ***, or null when you have not configured it.

Example:

"***"

oauth2_client_id
string | null

The client identifier Yuno authenticates with.

Example:

"acme_client_id"

oauth2_grant_type
string | null

The grant type Yuno requests the token with.

Example:

"client_credentials"

oauth2_scope
string | null

The scope Yuno requests the token with.

Example:

"webhooks:write"

oauth2_authorization_name
string | null

The header Yuno sends the token in.

Example:

"Authorization"

oauth2_include_client_id
boolean

Whether Yuno also sends the client identifier as a header on the token request.

Example:

true

enrollment_triggers
string[] | null

The enrollment events the webhook subscribes to.

Example:
payment_triggers
string[] | null

The payment events the webhook subscribes to.

Example:
report_triggers
string[] | null

The report events the webhook subscribes to.

Example:
subscription_triggers
string[] | null

The subscription events the webhook subscribes to.

Example:
onboarding_triggers
string[] | null

The onboarding events the webhook subscribes to.

Example:
renewal_days
integer | null

How many days before a renewal Yuno sends the CLOSE_TO_RENEWAL notification.

Example:

5

created_at
string<date-time>

The date and time the webhook was created, in ISO 8601.

Example:

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

updated_at
string<date-time>

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.

Example:

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