---
title: "List Webhooks"
method: GET
path: "/webhooks"
---

# List Webhooks

`GET /webhooks`

Returns the webhooks configured on an account, with their secrets masked. Filter by `state` to list only the active or the inactive ones.

## Query parameters

- `account_id` string, uuid, required
- `state` 'ACTIVE' | 'INACTIVE'

## Response `200`

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

- Webhook[]
  - `id` string — The unique identifier of the webhook.
  - `account_id` string, uuid — The unique identifier of the account the webhook belongs to.
  - `name` string — Your name for the webhook.
  - `state` 'ACTIVE' | 'INACTIVE' — `ACTIVE` webhooks receive notifications, `INACTIVE` ones do not. A webhook starts out `ACTIVE`.
  - `url` string — The endpoint Yuno sends the notifications to.
  - `api_key` string — Masked as `***`, or `null` when you have not configured it.
  - `secret` string — Masked as `***`, or `null` when you have not configured it.
  - `hmac_client_secret` string — Masked as `***`, or `null` when you have not configured it.
  - `oauth2_authentication_url` string — Your token endpoint.
  - `oauth2_client_secret` string — Masked as `***`, or `null` when you have not configured it.
  - `oauth2_client_id` string — The client identifier Yuno authenticates with.
  - `oauth2_grant_type` string — The grant type Yuno requests the token with.
  - `oauth2_scope` string — The scope Yuno requests the token with.
  - `oauth2_authorization_name` string — The header Yuno sends the token in.
  - `oauth2_include_client_id` boolean — Whether Yuno also sends the client identifier as a header on the token request.
  - `enrollment_triggers` string[] — The enrollment events the webhook subscribes to.
  - `payment_triggers` string[] — The payment events the webhook subscribes to.
  - `report_triggers` string[] — The report events the webhook subscribes to.
  - `subscription_triggers` string[] — The subscription events the webhook subscribes to.
  - `onboarding_triggers` string[] — The onboarding events the webhook subscribes to.
  - `renewal_days` unknown
  - `created_at` string, date-time — The date and time the webhook was created, in ISO 8601.
  - `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.

## Other responses

- `400` — The `account_id` is missing or invalid, or `state` is not `ACTIVE` or `INACTIVE`.
- `401` — Your API credentials are missing or invalid.
- `502` — The webhook service is temporarily unavailable.

---

[API](https://skmtc.net/y/apis/ai-caller.md) · [All operations](https://skmtc.net/y/apis/ai-caller/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/y/ai-caller/revisions/05b629819b49/schema)