---
title: "Create a Webhook"
method: POST
path: "/v2/webhooks"
tags: ["Webhooks"]
---

# Create a Webhook

`POST /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/post.ts> (a function with typed inputs; its response is checked against the schema)

Use the Create a webhook endpoint to create a new event subscription.

## Request body

- CreateWebhookRequest
  - `events` string[], required: [The webhook events](https://docs.synthesia.io/reference/webhook-events) for which notifications should be sent.
  - `url` string, url, required: The URL to send notifications to

## Response `201`

Webhook successfully created.

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

## 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)