---
title: "Retrieve a webhook"
method: GET
path: "/v2/webhooks/{webhook_id}"
tags: ["Webhooks"]
---

# Retrieve a webhook

`GET /v2/webhooks/{webhook_id}`

## Request

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

Retrieve a webhook endpoint to pull for the webhook status.

## Path parameters

- `webhook_id` string, required

## Response `200`

OK.

- WebhookResponse
  - `createdAt` unknown
  - `id` string
  - `secret` string
  - `status` unknown
  - `lastUpdatedAt` unknown
  - `url` string, url

## Other responses

- `400`: Bad Request.
- `403`: Forbidden - Wrong API key.
- `404`: Webhook ID doesn't exist.
- `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)