---
title: "List webhooks"
method: GET
path: "/v2/webhooks"
tags: ["Webhooks"]
---

# List webhooks

`GET /v2/webhooks`

## Request

- Base URL: `https://api.synthesia.io`
- URL: `https://api.synthesia.io/v2/webhooks`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/synthesia/apis/synthesia-api/docs/v2/webhooks/get.ts> (a function with typed inputs; its response is checked against the schema)

List all currently configured webhooks in your Synthesia account.

## Query parameters

- `limit` integer
- `offset` integer
- `deleted` boolean

## Response `200`

OK.

- WebhookListResponse
  - `webhooks` WebhookResponse[]
    - `createdAt` unknown
    - `id` string
    - `secret` string
    - `status` unknown
    - `lastUpdatedAt` unknown
    - `url` string, url
  - `nextOffset` integer

## Other responses

- `400`: Bad Request.
- `default`: Unexpected Server error.

---

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