---
title: "Add a Webhook Endpoint"
method: POST
path: "/v1/webhook/endpoint.add"
tags: ["Webhooks"]
---

# Add a Webhook Endpoint

`POST /v1/webhook/endpoint.add`

## Request body

- object
  - `url` string — The URL where you will receive events from HeyGen.
  - `events` string[] — The events that your URL is set to receive. `None` means all events. You can see supported events at [`/v1/webhook/webhook.list`](https://docs.heygen.com/reference/list-available-webhook-events).
  - `entity_id` string — Optional. The specific entity ID associated with the webhook. eg. video_id,project_id

## Response `200`

200

- object
  - `code` integer
  - `data` object
    - `endpoint_id` string
    - `username` string
    - `url` string
    - `status` string
    - `events` unknown
    - `secret` string
    - `created_at` string
  - `msg` unknown

## Other responses

- `400` — 400

---

[API](https://skmtc.net/heygen/apis/heygen-api.md) · [All operations](https://skmtc.net/heygen/apis/heygen-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/heygen/heygen-api/revisions/2f19176d6d56/schema)