HeyGen
Connect HeyGen to generate AI avatar videos, manage avatars and voices, and translate, lip-sync, and template your videos.
You paste one value into PopMCP: the HeyGen API key created in Settings, API, which PopMCP sends as the X-Api-Key header.
- Setup time
- 2 min
- Auth
- API credentials
- API base URL
- https://api.heygen.com
- Rate limits
- Endpoints are rate limited and answer 429 with a Retry-After header. Pay-as-you-go plans are capped at 10 concurrent video jobs, counting Video Agent sessions, avatar renders and translations. Per-endpoint request ceilings are not published.
Before you begin
- A HeyGen account you can sign into at app.heygen.com
- Access to the workspace whose credits PopMCP should spend. Keys are issued per workspace.
- Credits or a wallet balance on that workspace. Every render draws the balance down.
Get your credentials
Open the API dashboard
Sign in at app.heygen.com and open Settings, then API. The direct link is https://app.heygen.com/home?from=&nav=API.
API
Keys, usage and quota for this workspace.
| Name | Key | Status | Created |
|---|---|---|---|
| Default keyAcme Supply workspace | ••••••••••••d41b | Active | Mar 4, 2026 |
- Name
- Acme Supply
- Billing
- Pay-as-you-go wallet
- Concurrent jobs
- 10
Create the key and copy it
Click Create new key, name it PopMCP, and copy the value straight away.
API
Keys, usage and quota for this workspace.
Store the key in a password manager before closing the dialog.
Check the key works
Run curl -X GET "https://api.heygen.com/v3/users/me" -H "X-Api-Key: $HEYGEN_API_KEY". A 200 with your account details confirms the key is live.
Paste the key into PopMCP
Enter the value in API key on PopMCP's HeyGen form, then save.
Connect in PopMCP
Open your workspace, choose HeyGen in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| API keysecret | HeyGen dashboard → Settings → API (or Space Settings → API Token). Sent as the X-Api-Key header. Stored encrypted; used server-side only. The connection is locked to this key's account.Encrypted with AES-256-GCM on save and never shown again. |
PopMCP verifies the credential against HeyGen immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Verify it worked
PopMCP shows HeyGen as Connected and the avatar and voice listing tools return your workspace's avatars and voices instead of an authentication error.
Troubleshooting
401 unauthorized
Why: The key was mistyped, truncated, or deleted from Settings, API.
Fix: Create a fresh key, copy it with the copy button, and re-save the PopMCP connection.
You closed the dialog before copying the key
Why: The full value is only shown at creation time.
Fix: Delete that key on the API page and create a new one.
Videos fail with an insufficient-credits error
Why: The workspace behind the key has no remaining credits or wallet balance.
Fix: Top up the wallet, or issue a key from a workspace that has credits.
429 Too Many Requests
Why: A rate limit was hit, or more than 10 video jobs are running at once on Pay-as-you-go.
Fix: Wait for the Retry-After interval, let running renders finish, or ask HeyGen to raise the quota.
Tools see the wrong avatars
Why: The key was created while a different workspace was selected.
Fix: Switch to the correct workspace in app.heygen.com and create a new key there.