Skip to main content
GET
Retrieve a Webhook
Returns a webhook by its unique identifier, the one you get from Create a Webhook or List Webhooks. Secrets are masked. The webhook must belong to the account you pass in account_id. Any other identifier returns 404 WEBHOOK_NOT_FOUND. See Webhooks Overview for what each field configures.

Authorizations

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

Path Parameters

webhook_id
string
required

The unique identifier of the webhook, as returned by Create a Webhook.

Example:

"12345"

Query Parameters

account_id
string<uuid>
required

The unique identifier of the account the webhook belongs to.

Example:

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

Response

The webhook.

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"