> ## Documentation Index
> Fetch the complete documentation index at: https://heygen-1fa696a7.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Avatar Consent

> How HeyGen verifies that the person in a digital twin agreed to be cloned — the three levels of consent access, and the API flow for collecting it.

Before you can generate video with a **digital twin** ([`type: "digital_twin"`](/docs/create-avatar#digital-twin)), HeyGen needs proof that the person depicted agreed to be cloned. This protects the avatar subject, your account, and HeyGen — and it's what lets you use a real person's likeness responsibly at scale.

<Note>
  Consent applies only to **digital twin** avatars. Photo avatars (`type: "photo"`) and prompt-to-avatar characters (`type: "prompt"`) depict no real, identifiable person and do **not** require consent.
</Note>

## The three levels of access

Consent is offered as **three increasing levels of access**. Each level removes friction from the flow, and each is unlocked for a progressively narrower set of accounts. Higher levels are more powerful and correspondingly more restricted.

| Level                         | Flow                                                                                                                         | Who it's for    | Availability                                          |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | --------------- | ----------------------------------------------------- |
| **1. Record via webcam**      | The avatar subject records a short consent statement on camera through HeyGen's hosted consent page.                         | All customers   | Available today in v3                                 |
| **2. Upload a consent video** | You supply a pre-recorded consent video instead of recording live — more flexible, but consent is still explicitly captured. | Enterprise only | Coming soon                                           |
| **3. Skip the consent flow**  | Consent collection is waived entirely for accounts that have signed an indemnity agreement.                                  | Enterprise only | [Contact sales](https://www.heygen.com/contact-sales) |

## Collect consent via API

The v3 API drives **Level 1** (record via webcam). Initiate a consent flow for an avatar group; the response returns a URL the avatar subject visits to approve usage. Full schema: [`POST /v3/avatars/{group_id}/consent`](/reference/create-avatar-consent).

### Request

```bash theme={null}
curl -X POST "https://api.heygen.com/v3/avatars/group_xyz789/consent" \
  -H "X-Api-Key: $HEYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reroute_url": "https://heygen.com/consent-done"
  }'
```

| Parameter     | Type   | Required | Description                                                                                 |
| ------------- | ------ | -------- | ------------------------------------------------------------------------------------------- |
| `reroute_url` | string | No       | Redirect URL after the subject completes consent. Defaults to HeyGen's own completion page. |

### Response

```json theme={null}
{
  "data": {
    "avatar_group": {
      "id": "group_xyz789",
      "name": "My Digital Twin",
      "consent_status": "pending",
      "looks_count": 1,
      "created_at": 1717000000
    },
    "url": "https://heygen.com/consent/abc123..."
  }
}
```

| Field                         | Type   | Description                                                             |
| ----------------------------- | ------ | ----------------------------------------------------------------------- |
| `url`                         | string | Consent page URL. Send this to the avatar subject to complete approval. |
| `avatar_group.consent_status` | string | Current consent status (e.g. `"pending"`).                              |

<Tip>
  Check `consent_status` on the avatar group via [`GET /v3/avatars/{group_id}`](/reference/get-avatar-group) to know when consent is complete. It is `null` for photo and prompt avatars, which never require consent.
</Tip>

## Where consent fits

Consent is one step in the digital twin flow. To create the avatar itself, see [Create Avatar](/docs/create-avatar); to browse the resulting characters and looks, see [Avatars](/docs/avatars) and [Avatar Looks](/docs/avatar-looks).