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

# Create a Webhook

`POST /v2/webhooks`

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.net/synthesia/apis/synthesia-api.md) · [All operations](https://skmtc.net/synthesia/apis/synthesia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synthesia/synthesia-api/versions/f0f34ae0591d/schema)