Skip to main content

​
HeyGen

In one line: Let your UnleashX agent turn a script into a video of a presenter — either a digital avatar or a talking version of a photo you provide.

​
1. Overview

HeyGen creates avatar videos: you give it text and it produces a video of a lifelike presenter speaking your words. It can use a built-in avatar, or animate a still photo into a “talking photo.” Once connected, your agent can generate text-to-video (an avatar reads your script) and image-to-video (a supplied photo becomes the speaker), optionally choosing a voice. The agent can submit the job and either return immediately with a video ID or wait for the finished video URL. Connecting HeyGen to UnleashX lets your agents produce on-brand presenter videos at scale — personalized welcome messages, product walkthroughs, or campaign clips — straight from a script.

​
2. What you’ll need

HeyGen is built into UnleashX. There is no HeyGen account for you to create and no API key for you to manage.
  • An active UnleashX account.
  • The HeyGen / avatar-video feature enabled on your workspace/plan.
  • A script (the text the avatar will say). For talking-photo, a public image URL.
  • Permission to edit the agent (admin or editor role). Without it, ask a workspace admin to enable the feature.

​
3. Get your credentials

There are no credentials to create. HeyGen is platform-managed — UnleashX provisions and rotates the underlying HeyGen API key. You never see or handle it.
If you are a workspace admin, optional platform-side configuration includes the HeyGen base URL and the generation endpoint (UnleashX ships working defaults). Avatar IDs and voice IDs are optional inputs you can pass per request.

​
4. Connect on UnleashX

1

Open your agent

Go to https://www.tryunleashx.com and open the agent that should generate avatar videos.
2

Open Data Connectors

In the agent, click Data Connectors.
3

Find HeyGen and add it

Locate HeyGen and click Connect / Add. It’s platform-managed — no key to paste, it activates immediately.
4

Confirm it's connected

The HeyGen tool should now show a Connected badge.

​
Use HeyGen in a Workflow

Once connected, you can add HeyGen to any automation from the Workflows builder. Its triggers and tools appear in the Apps panel, marked with an MCP badge.
1

Add a trigger or action node

Open Workflows → New Workflow. On the canvas, click + Add Trigger (or the + below any node) to add a step.Add a trigger on the workflow canvas
2

Pick HeyGen from the Apps panel

In the Paths panel, open the Apps tab and select HeyGen. Use the search box if you have many connectors.Choose your app from the Apps list
3

Choose a trigger or tool

Pick the trigger or action you want. Configure its fields — required fields are marked with a red asterisk (*).
4

Add or select your account

Under Selected account, choose an already-connected account, or click Add Account to connect one now.
5

Save and test

Fill in the remaining fields and click Save. Use Test to verify the step, then toggle Publish when the workflow is ready.
The steps are the same for every connector. For the full workflow builder guide, see Using MCP in Workflows.

​
5. Available tools

The generate tools are marked ✏️ Yes because they create a new video. They do not modify or delete any existing data.

​
6. Example usage

“Have an avatar read this welcome message for new customers.” → Runs Text to Video with the script (and optional avatar/voice), returning a video ID or URL. “Turn this headshot into a short talking-photo intro.” → Runs Image to Video with the image URL and the script.

​
7. Permissions & data access

UnleashX can:
  • Send your script (and optional image URL, avatar, voice) to HeyGen.
  • Submit the generation job and fetch the resulting video status/URL.
UnleashX cannot:
  • Generate video from content you don’t provide.
  • Edit or delete videos created outside this flow.
  • Access your HeyGen account assets beyond what you pass in.
To disconnect: Open the agent → Data Connectors → HeyGen → Disconnect. Access is revoked immediately.

​
8. Troubleshooting

For general connector issues, see /mcp/integrations.

​
9. Frequently asked questions

Is my script or photo stored? They’re sent to HeyGen to render the video. They are not retained by the integration beyond producing your result. Do I need a HeyGen account? No. HeyGen is platform-managed — UnleashX provides and rotates the key. Can I choose the avatar and voice? Yes. Pass an avatar_id, voice_id, or talking_photo_id per request; otherwise sensible defaults are used. Can multiple team members use it? Yes. Once enabled on the workspace, anyone with access to the agent can generate videos.

​
10. References