---
title: "HeyGen video-completion webhook."
method: POST
path: "/webhooks/heygen"
tags: ["Webhooks"]
---

# HeyGen video-completion webhook.

`POST /webhooks/heygen`

## Request

- Base URL: `https://api.avatarfactory.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.avatarfactory.io/webhooks/heygen`
- Auth: none declared

<br/>Called by HeyGen after avatar video rendering finishes or fails.<br/>The request body is verified with HMAC-SHA256 before dispatch.

## Request body

- WebhookEventRequest: HeyGen webhook payload — event_type + event_data envelope.
  - `event_data` object
  - `event_type` string

## Response `200`

OK

- WebhookResponse
  - `message` string
  - `ok` boolean, required

## Other responses

- `401`: Unauthorized
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

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