otherapi_key

HeyGen

HeyGen is an innovative video platform that harnesses the power of generative AI to streamline your video creation process

Verdict

HeyGen generates AI videos with synthetic avatars and voices. In Switchy, @mention HeyGen to create talking-head videos from scripts, manage personalized video campaigns at scale, or turn text into avatar presentations without recording. Teams use it for training content, product demos, and outreach videos. The MCP exposes 35 tools covering video creation, asset management, webhooks, and streaming tokens. You'll need an API key from your HeyGen account. Trade-off: video rendering takes time — expect minutes, not seconds, for most outputs.

Common use cases

Generate training videos from documentation
Create personalized outreach videos at scale
Turn meeting notes into avatar summaries
Build product demo videos without filming
Automate video content for social campaigns

Integration

Vendor: HeyGen
Category: other
Auth: API_KEY
Tools: 35
Composio slug: heygen

Tools

Add contact to personalized video project
This endpoint allows you to add one or more contacts to a specific personalized video project in the heygen platform. it is used when you need to associate individual contact information with a project, likely for the purpose of creating ta
Add new asset
Creates a new asset in the heygen platform. this endpoint allows users to add various types of assets that can be used in video generation, such as avatars, backgrounds, or other content elements. the asset is created by sending plain text
Add webhook endpoint
Adds a new webhook endpoint to receive real-time notifications for specified heygen events. this endpoint allows you to configure where and for which events you want to receive updates, enabling seamless integration of heygen's capabilities
Create streaming token with expiry
Creates a new streaming token for use with heygen's real-time avatar and voice chat services. this endpoint generates a unique, time-limited token that authenticates and authorizes access to heygen's streaming capabilities. use this endpoin
Delete talking photo by id
destructive
Deletes a specific talking photo from the heygen platform using its unique identifier. this endpoint should be used when you need to permanently remove a talking photo resource, such as when it's no longer needed or to manage storage. once
Delete video
destructive
The video.delete endpoint allows users to remove a specific video from their heygen account. this operation moves the video to the trash, from where it can be restored if needed. use this endpoint when you want to delete a video that is no
Delete webhook endpoint
destructive
Deletes a specific webhook endpoint from the heygen system. this operation permanently removes the configured webhook, stopping any future notifications or data transmissions to the previously specified url. use this endpoint when you no lo
Fetch personalized video project detail
Retrieves detailed information about a specific personalized video project in the heygen platform. this endpoint allows you to fetch comprehensive data about a project, including its current status, configuration settings, and any other rel
Generate video template with variables
This endpoint generates a customized video based on a pre-existing template using heygen's ai-driven platform. it allows for dynamic content creation by accepting a video title and a set of variables that can be used to personalize the vide
Generate video with inputs
Generates a customized video using heygen's ai-driven platform. this endpoint allows you to create videos featuring digital avatars with specified voices, enabling dynamic content creation. it's ideal for producing personalized video conten
Get template by id
Retrieves a specific template from the heygen platform using its unique identifier. this endpoint allows users to access detailed information about a particular template, including its structure, elements, and customization options. it's pa
Interrupt streaming session
Interrupts an ongoing streaming session with an interactive avatar. this endpoint allows immediate termination of the avatar's current action or speech, providing control over the flow of interaction. use this when you need to abruptly stop
List available voices
Retrieves a list of available voice models and options that can be used with heygen's ai-driven video creation platform. this endpoint provides information about the various voice options, including different languages and voice characteris
List avatars endpoint
Retrieves a list of available avatars from the heygen platform. this endpoint allows users to fetch both public and private avatars, depending on their access rights and the specified parameters. it's particularly useful for applications th
List streaming avatars
Retrieves a list of available avatars for streaming purposes in the heygen platform. this endpoint allows developers to access the collection of realistic avatars that can be used for creating professional-looking videos with ai-generated c
List talking photo entries
Retrieves a list of talking photos created using the heygen platform. this endpoint allows users to fetch information about their existing talking photo projects, which are interactive images capable of speaking and engaging users. it's use
List videos
Retrieves a list of videos associated with the user's account on the heygen platform. this endpoint is crucial for content management, allowing users to view and organize their video library efficiently. it provides an overview of all video
List voice endpoints
Retrieves a comprehensive list of all available voices in the heygen platform. this endpoint should be used when you need to obtain information about the voice options that can be utilized for avatar creation or text-to-speech functionaliti
List webhook endpoints
Retrieves a list of all webhook endpoints configured for your heygen account. this endpoint allows you to view and manage the webhook configurations that receive notifications about various events in your heygen integration. use this endpoi
List webhooks
Retrieves a list of all webhooks configured for your heygen account. this endpoint allows you to view and manage the webhook integrations set up to receive real-time notifications about events in your heygen workspace, such as video generat
Post streaming ice candidates
This endpoint is used to submit ice (interactive connectivity establishment) candidate information for a specific streaming session in the heygen platform. it plays a crucial role in establishing and managing peer-to-peer connections for re
Post streaming task session
The streamingtask endpoint initiates a real-time speaking task for an ai-driven avatar within an active streaming session. it enables developers to make avatars vocalize specified text, creating interactive and dynamic user experiences. thi
Post talking photo binary image
Creates a talking photo by processing an uploaded image file. this endpoint enables users to transform static images into interactive, speaking visual content using heygen's advanced ai technology. it accepts jpeg or png image files and lik
Post video translate request
The translatevideo endpoint enables the translation of video content from one language to another. it offers flexible options for translating either the entire video or just the audio track, accommodating various use cases. this tool is ide
Retrieve all templates
Retrieves a list of available avatar templates from the heygen platform. this endpoint allows users to access pre-designed avatars that can be used for creating professional-looking videos. it's particularly useful when you need to browse o
Retrieve audience video details
Retrieves detailed information about the audience for personalized videos. this endpoint provides insights into the target audience characteristics, preferences, and engagement metrics for heygen's ai-generated personalized video content. i
Retrieve avatars collection
Retrieves a list of available avatars from the heygen platform. this endpoint allows users to access the vast library of realistic avatars that can be used for video creation. it should be used when you need to browse or select avatars for
Retrieve streaming list
Retrieves a list of active or available streaming sessions or content within the heygen platform. this endpoint allows users to get an overview of ongoing streams, which may include live avatar interactions, real-time video generations, or
Retrieve user remaining quota
Retrieves the current remaining quota for the authenticated user on the heygen platform. this endpoint allows users to check their available resources or actions within their account limits. it should be used to monitor usage and plan resou
Retrieve video status
Retrieves the current status of a video in the heygen platform. this endpoint is used to check the progress of video processing, particularly useful for avatar videos that may require time to generate. it provides real-time information on w
Retrieve video translation by id
Retrieves the current status of a video translation job in the heygen platform. this endpoint allows users to check the progress of their requested video translations, providing information such as whether the translation is in progress, co
Retrieve video translation target languages
Retrieves a list of all available target languages supported by heygen's video translation feature. this endpoint should be used when you need to know which languages are available for translating your video content. it provides an up-to-da
Set streaming quality endpoint
Initiates a new streaming session with heygen, allowing users to start an avatar-based stream with specified quality settings. this endpoint should be used when starting a new interactive content session or when creating a personalized digi
Start streaming session
Initiates a new streaming session for real-time communication in the heygen platform. this endpoint is used to set up a webrtc connection for video, audio, and data streaming, likely for interactions with ai avatars. it requires a unique se
Stop streaming session
The streaming.stop endpoint is used to terminate an active streaming session in the heygen api. this endpoint should be called when you want to end a real-time data transfer session, such as when closing an interactive avatar conversation o

Setup

Setup guide

11. In Switchy, open your workspace settings and navigate to the MCP Integrations section. 2. Click 'Add Integration' and select HeyGen from the list. 3. Go to your HeyGen dashboard (app.heygen.com), open API settings, and generate a new API key with full access to video and asset endpoints. 4. Paste the API key into Switchy's connection form and click 'Connect'. 5. Switchy will verify the key by fetching your account details — if successful, you'll see a green checkmark. 6. Open any Space, type '@HeyGen' in the chat, and ask it to list your available avatars or create a test video from a short script. 7. If the response includes avatar names or a video generation confirmation, the integration is live and ready for production workflows.

What teammates see: by default, memories from HeyGen are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

List Available Avatars

@HeyGen show me all the avatars I have access to in my account, including their names and IDs.

Open in a Space →

Create Talking-Head Video

@HeyGen create a video using avatar ID [paste ID] with this script: 'Welcome to our Q2 product update. Today we're launching three new features that will save your team hours every week.'

Open in a Space →

Check Video Status

@HeyGen check the status of video ID [paste ID] and let me know if it's finished rendering or still processing.

Open in a Space →

Add Contacts to Campaign

@HeyGen add these three contacts to project ID [paste ID]: Alice (alice@example.com), Bob (bob@example.com), Carol (carol@example.com).

Open in a Space →

Delete Old Video

@HeyGen delete video ID [paste ID] from my account and confirm when it's moved to trash.

Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@HeyGen list all personalized video projects in my account and show me their current status and contact counts

Output

Based on your HeyGen account, you have 3 active personalized video projects: 1. **Q4 Sales Outreach** - Status: Ready for generation, 247 contacts added, created Nov 15 2. **Customer Onboarding Series** - Status: In progress (67% complete), 89 contacts, created Dec 2 3. **Holiday Campaign Draft** - Status: Draft, 0 contacts, created Dec 10 The Q4 Sales Outreach project appears ready to generate videos. Would you like me to check the generation status or add more contacts to any project?

Notes

This example shows HeyGen's project management capabilities. The MCP can list and inspect personalized video campaigns, which is useful for tracking bulk video generation workflows. Requires API key with read access to projects. Note that contact counts and generation progress are account-specific—your actual projects will differ.

Prompt

@HeyGen add these 5 contacts to my 'Customer Onboarding Series' project: emma@startup.io, james@startup.io, lisa@startup.io, marcus@startup.io, nina@startup.io

Output

Successfully added 5 contacts to the 'Customer Onboarding Series' project (project ID: pv_abc123xyz): ✓ emma@startup.io ✓ james@startup.io ✓ lisa@startup.io ✓ marcus@startup.io ✓ nina@startup.io The project now has 94 total contacts. Each contact will receive a personalized video once you trigger generation. The project remains in 'Ready' status—you can add more contacts or start generating videos through the HeyGen dashboard.

Notes

This demonstrates HeyGen's bulk contact management for personalized video campaigns. The MCP writes contact data to your project, which then drives individualized video generation. Be aware this is a write operation that modifies your HeyGen project state. You'll need to trigger actual video generation separately (typically through HeyGen's UI or a generate endpoint).

Prompt

@HeyGen create a streaming token for a real-time avatar session that expires in 2 hours, then explain what I'd use it for

Output

Created a new streaming token for HeyGen's real-time avatar service: **Token:** `sk_live_a7f3e9d2c1b8...` (truncated for security) **Expires:** 2:00 PM PST (2 hours from now) **Use case:** This token authenticates WebRTC connections to HeyGen's interactive avatar API. You'd use it to power real-time conversational AI experiences—think a customer service avatar that responds to voice/text input with synchronized lip movements and expressions. The token should be passed to HeyGen's JavaScript SDK when initializing a streaming session. Once expired, you'll need to generate a new token to continue streaming.

Notes

This showcases HeyGen's real-time avatar streaming capability, which differs from their batch video generation. The token enables live, interactive avatar sessions (not pre-rendered videos). Useful for building conversational AI interfaces. The 2-hour expiry is a security feature—tokens are meant to be short-lived. You'll need to integrate HeyGen's streaming SDK separately to actually use the token.

Use-case deep-dives

Sales outreach video personalization

When HeyGen makes sense for high-touch prospect sequences

A 6-person sales team running ABM campaigns needs to send personalized video intros to 200 enterprise prospects per quarter. HeyGen's personalized video project tools let you batch-generate videos with dynamic contact data (name, company, pain point) without re-recording each one. The 'add contact to project' endpoint means your AE can upload a CSV from Salesforce and trigger renders in one API call. This works if your ICP is narrow enough that one avatar and script template fit most prospects. If you're sending to 10 different buyer personas or your reps want to ad-lib every video, you'll spend more time managing projects than recording manually. The break-even is around 50+ videos per month where the template ROI justifies the setup cost.

Customer onboarding video library

HeyGen for scaling product walkthroughs without a video team

A 12-person SaaS startup needs to ship onboarding videos for 8 product modules, updated every release cycle. HeyGen's asset and video endpoints let your PM or support lead script the walkthrough, pick an avatar, and render without hiring a videographer or waiting on the founder's calendar. The webhook system notifies Slack when renders finish so you can review and publish same-day. This setup works if your product UI is stable enough that you're updating scripts, not re-shooting screen recordings every sprint. If your app changes weekly or you need to show live cursor movement and complex interactions, a Loom-style screen recorder is faster. HeyGen wins when you want a polished, voice-over-slides aesthetic at a cadence traditional video production can't match.

Internal comms for distributed teams

When talking-head announcements beat another all-hands Zoom

A 40-person remote company wants the CEO to deliver quarterly updates without scheduling across 6 time zones. HeyGen's talking photo and streaming token tools let leadership record a 3-minute message once, render it with the CEO's avatar, and drop it in Slack for async viewing. The delete and webhook endpoints mean your ops person can manage a library of announcements without cluttering storage or waiting on manual checks. This works if your culture values the personal touch of a face over a written memo, but doesn't require live Q&A every time. If your team expects real-time interaction or the message is sensitive enough that deepfake concerns outweigh convenience, stick to live video. HeyGen is the move when you want the gravitas of a recorded message at the flexibility of a doc.

Frequently asked

What does the HeyGen MCP let me do in Switchy?

It lets your team generate AI avatar videos, manage talking photos, and run personalized video campaigns directly from Switchy. You can create streaming tokens for real-time avatar chat, add assets like backgrounds and avatars, and track video generation status without switching to HeyGen's dashboard. Useful for teams building video content at scale or embedding avatar interactions in workflows.

Do I need a HeyGen API key to connect this MCP?

Yes. You'll need an API key from your HeyGen account settings. HeyGen doesn't use OAuth, so whoever connects the MCP must have access to generate keys in your HeyGen workspace. If you're on a team plan, check with your HeyGen admin before creating a new key—some plans limit how many keys you can issue.

Can the MCP edit videos after they're generated?

No. Once HeyGen renders a video, it's immutable. The MCP can delete videos (moves them to trash) or fetch their status, but you can't re-edit content or swap avatars post-render. If you need changes, you create a new video project with updated parameters. Think of it as a one-way generation pipeline, not a video editor.

Why use this MCP instead of HeyGen's web app?

The MCP is faster for bulk operations and workflow automation. If you're generating dozens of personalized videos or triggering avatar streams from Slack messages, doing it through Switchy beats clicking through HeyGen's UI. For one-off videos with complex editing, the web app's visual tools are still easier. Use the MCP when repetition or integration matters more than UI polish.

Who on my team should connect the HeyGen MCP?

Whoever manages your HeyGen account and understands your video generation limits. The API key grants access to all 35 tools, including deleting videos and managing webhooks, so don't hand it to someone who's just testing. Video generation counts against your HeyGen plan's credit quota, not Switchy's—so the connector needs visibility into both systems' usage.