> ## Documentation Index
> Fetch the complete documentation index at: https://docs.liveavatar.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HeyGen to LiveAvatar Migration

> Step-by-step guide for migrating from HeyGen Interactive Avatar

## Step 1: Copy your assets

Navigate to [app.liveavatar.com](https://app.liveavatar.com). The system automatically detects any existing HeyGen avatars or knowledge bases and creates copies in your LiveAvatar account.

<Info>
  Individual voices cannot currently be migrated. Also, changes made in either platform will not sync — these are independent copies.
</Info>

## Step 2: Transition your implementation

### Subscription

If you don't have an existing LiveAvatar subscription, you'll receive a temporary **30-day trial** to test during the transition.

### API changes

Update all API calls from HeyGen endpoints to LiveAvatar endpoints. Key changes:

**Session initialization** — simplified from 3 calls to 2:

| HeyGen (old)                                       | LiveAvatar (new)                     |
| -------------------------------------------------- | ------------------------------------ |
| Create Session Token → New Session → Start Session | Create Session Token → Start Session |

**Session management** — REST task endpoints replaced with events:

| HeyGen (old)         | LiveAvatar (new)              |
| -------------------- | ----------------------------- |
| `repeat` endpoint    | `avatar.speak_text` event     |
| `chat` endpoint      | `avatar.speak_response` event |
| `interrupt` endpoint | `avatar.interrupt` event      |

**Other changes:**

* Close Session → Stop Session
* List Sessions (Active/History) → single List Sessions endpoint (use `type` parameter)
* Knowledge Base → renamed to **Context**
* Avatar listing split into List Public Avatars and List User Avatars

### Recommended pattern

Create the session token on your backend, pass the session start data to your client, and let users start the session on your frontend.

## Step 3: Clean up HeyGen

After migrating, cancel your HeyGen subscription. LiveAvatar pricing is significantly cheaper on a per-minute basis.

## More resources

* [LiveAvatar vs HeyGen comparison](/docs/faq/heygen-comparison)
* [Migration FAQs](/docs/faq/migration-faqs)
