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

# List Webhooks

`GET /v1/webhooks`

## Request

- Base URL: `https://api.browserbase.com`
- URL: `https://api.browserbase.com/v1/webhooks`
- Auth: API key in header `X-BB-API-Key`

List the project's webhooks, newest first. Signing secrets are not included. Page by passing the previous response's `nextCursor` as `cursor`; a null `nextCursor` means there are no further pages.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

A page of webhooks.

- object: A page of webhooks. Signing secrets are not included.
  - `data` Webhook[], required: The page of webhooks, newest first.
    - `id` string, required: Unique identifier for the webhook.
    - `projectId` string, required: The project the webhook belongs to.
    - `endpoint` string, uri, required: HTTPS URL that event deliveries are POSTed to. Must be publicly reachable.
    - `eventTypes` string[], required: Event types this webhook subscribes to. Unknown types are rejected.
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `limit` integer, required: The maximum number of results returned in this page.
  - `nextCursor` string, nullable, required: Cursor for the next page. Pass it back as `cursor` to continue paging. null when there are no more results.

## Changes

- **2026-10-16** `266d5199a560`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/browserbase/apis/browserbase-api/changes/v1/webhooks/get.md)

---

[API](https://skmtc.dev/browserbase/apis/browserbase-api.md) - [All operations](https://skmtc.dev/browserbase/apis/browserbase-api/llms.txt) - [OpenAPI document](https://skmtc.dev/browserbase/apis/browserbase-api/revisions/106c5f72c742?raw)