---
title: "List webhook configurations"
description: "Lists the authenticated user's webhook configurations. Masks secrets."
canonical: https://y2.dev/docs/api/reference/webhooks/listWebhooks/
---

Endpoint Reference[Webhooks](https://y2.dev/docs/api/reference/webhooks)

# List webhook configurations

Lists the authenticated user's webhook configurations. Masks secrets.

`GET https://api.y2.dev/api/v1/webhooks`

- Operation ID: `listWebhooks`
- Required scopes: `webhooks:manage`
- Contract: https://y2.dev/openapi.json

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | Webhook configurations | `WebhookListResponse` |
| 401 | Missing or invalid API key |  |
| 403 | Insufficient permissions or access denied |  |
| 429 | Rate limit exceeded (per-key or per-account aggregate) |  |
| 500 | Internal server error |  |

### 200 response fields

| Field | Type | Description |
| --- | --- | --- |
| `data[]` | array of `WebhookConfig` |  |
| `data[].id` | string | Stable public webhook configuration ID |
| `data[].type` | string |  |
| `data[].name` | string | Webhook display name |
| `data[].url` | string (uri) | Webhook endpoint URL |
| `data[].status` | `active`, `disabled` |  |
| `data[].signing` | object |  |
| `data[].customHeaders[]` | array of string | Configured header names. Values are never returned. |
| `data[].deliveryHealth` | object |  |
| `data[].createdAt` | string (date-time) |  |
| `data[].updatedAt` | string (date-time) |  |
| `data[].links` | object |  |
| `meta` | `PublicListMeta` |  |
| `meta.count` | integer |  |
| `meta.pageCount` | integer |  |
| `meta.limit` | integer |  |
| `meta.isDone` | boolean |  |
| `meta.hasMore` | boolean |  |
| `meta.nextCursor` | string or null |  |
| `meta.asOf` | string (date-time) |  |
| `meta.page` | `PublicPageMeta` |  |
| `links` | `PublicCollectionLinks` |  |
| `links.self` | string |  |
| `links.next` | string or null |  |
