hey-gen

name

hey-gen

description

HeyGen is an AI video generation platform that enables users to create, translate, and personalize high-quality videos using realistic AI avatars and voiceovers, allowing businesses and creators to produce scalable video content from text without cameras or editing expertise. Read and write HeyGen data through One: videos, videotranslations, lipsyncs, webhookendpoints, videoagents, avatarlooks and more, 62 actions with real parameter documentation. Use whenever the user asks to look something up in HeyGen, create or update a record there, or build code against the HeyGen API.

HeyGen through One

HeyGen is an AI video generation platform that enables users to create, translate, and personalize high-quality videos using realistic AI avatars and voiceovers, allowing businesses and creators to produce scalable video content from text without cameras or editing expertise.

One exposes HeyGen through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform hey-gen if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm HeyGen is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real HeyGen account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Videos

Action	Method	Path	Action id
Get a Video	GET	/v3/videos/{{videoId}}	conn_mod_def::GKhIPvNoFvA::R4-m0EIoRwiOXFD731w0rA
Get Video Details	GET	/v2/videos/{{videoId}}	conn_mod_def::GKhIPuOQjDA::cRg3n04iSeaBIkSGZULscQ
List Videos	GET	/v2/videos	conn_mod_def::GKhIPwNIudA::_kGRBS5pQHmKZJQEwF-4PQ
List Videos	GET	/v3/videos	conn_mod_def::GKhIP53B3IA::_6951nYjSS2428hh9CNRQQ
Create Avatar Video	POST	/v2/videos	conn_mod_def::GKhIPlqZqog::8lO_NoWdTlqmEGaj5G9wBQ
Create Video	POST	/v3/videos	conn_mod_def::GKhIPmE-4kA::s2hBlHAESECw0pqnNzmh3Q
Delete a Video	DELETE	/v3/videos/{{videoId}}	conn_mod_def::GKhIPusMKqA::prjoCw3cSlOY_T0TD-uXnQ
Delete a Video	DELETE	/v2/videos/{{videoId}}	conn_mod_def::GKhIPxA5Hng::cDRE53i1Tx2iW-HNESlLEg

VideoTranslations

Action	Method	Path	Action id
Download a Proofread SRT	GET	/v3/video-translations/proofreads/{{proofreadId}}/srt	conn_mod_def::GKhIPSs_Xxg::qXOHEs2NTNyF-dHJz2SaRw
Get a Video Translation	GET	/v3/video-translations/{{videoTranslationId}}	conn_mod_def::GKhIPcn5htg::djAu_2D1TROAvtPp-ZF_xQ
List Video Translations	GET	/v3/video-translations	conn_mod_def::GKhIPmF7sKg::YrtdichKRVmx8CdHWVcvSQ
Create Video Translation	POST	/v3/video-translations	conn_mod_def::GKhIPRylUbA::7SGWGYh0QI2viqG4LMVUAQ
Delete a Video Translation	DELETE	/v3/video-translations/{{videoTranslationId}}	conn_mod_def::GKhIPR5rsgA::Gnv67RkyTbSD9okzmygBFw
Generate Video from a Proofread Session	POST	/v3/video-translations/proofreads/{{proofreadId}}/generate	conn_mod_def::GKhIPSzr1pg::uxbiqsLgRfe8ptmeJcBccQ
Update a Video Translation	PATCH	/v3/video-translations/{{videoTranslationId}}	conn_mod_def::GKhIPl1z95A::HmZxEZClTSu7mKF19AxzKQ

Lipsyncs

Action	Method	Path	Action id
Get a Lipsync	GET	/v3/lipsyncs/{{lipsyncId}}	conn_mod_def::GKhIO1-0lGg::bw9GCKCcQ1Kow1nfVRNiig
List Lipsyncs	GET	/v3/lipsyncs	conn_mod_def::GKhIO1-0dSg::e-cPX-l-SxCN3_0uHfIqcA
Create Lipsync	POST	/v3/lipsyncs	conn_mod_def::GKhIOpLOjfA::P11I14ekQa6ViMHCcK588g
Delete Lipsync	DELETE	/v3/lipsyncs/{{lipsyncId}}	conn_mod_def::GKhIOpcB9qA::XZGN-HFFSDyCCd5WdmLj4w
Update a Lipsync	PATCH	/v3/lipsyncs/{{lipsyncId}}	conn_mod_def::GKhIO2Gwi3g::O5ef-4ZfSqqtI4k15Z1ZOA

WebhookEndpoints

Action	Method	Path	Action id
List Webhook Endpoints	GET	/v3/webhooks/endpoints	conn_mod_def::GKhIQGVZq9g::kaIdNSASTiytnKHNg1JW9w
Create Webhook Endpoint	POST	/v3/webhooks/endpoints	conn_mod_def::GKhIQF_FBXg::G5krDX6XRL6ckZ4ujERuhA
Delete a Webhook Endpoint	DELETE	/v3/webhooks/endpoints/{{endpointId}}	conn_mod_def::GKhIQF0jvhg::i1PMtD7LSg2krTfQGnsS2A
Rotate a Webhook Endpoint's Signing Secret	POST	/v3/webhooks/endpoints/{{endpointId}}/rotate-secret	conn_mod_def::GKhIQPvi7ug::1txOTRj9SAqqrmFkxDj9GQ
Update a Webhook Endpoint	PATCH	/v3/webhooks/endpoints/{{endpointId}}	conn_mod_def::GKhIQPZH57g::IUiD_18OSIiEJaMXoNDdPg

VideoAgents

Action	Method	Path	Action id
Get a Video Agent Session	GET	/v3/video-agents/{{sessionId}}	conn_mod_def::GKhIPAt0DEg::5g5UDPDSSo66vzx1lZwjZQ
Create Video Agent Session	POST	/v3/video-agents	conn_mod_def::GKhIPAsA57g::k_l30feaTU2-B5xOjJ3apQ
Send a Message or Request a Revision for a Video Agent Session	POST	/v3/video-agents/{{sessionId}}	conn_mod_def::GKhIPJ16V3g::Vq8rb6W9S1WydeOSLhwj-w
Stop a Video Agent Session	POST	/v3/video-agents/{{sessionId}}/stop	conn_mod_def::GKhIPJQLvsA::ERVqL5mnSVaa_J3V94BG4A

AvatarLooks

Action	Method	Path	Action id
Get an Avatar Look	GET	/v3/avatars/looks/{{lookId}}	conn_mod_def::GKhIOgSwtAg::xTGvx9hMRoS7JP0yEhWDoQ
List Avatar Looks	GET	/v3/avatars/looks	conn_mod_def::GKhIOsvcUCg::QAp17QNmTy-BWKm4qeYtUw
Update an Avatar Look	PATCH	/v3/avatars/looks/{{lookId}}	conn_mod_def::GKhIOrD-x7g::56WoTnEZRpi39hmUV1SxZQ

Voices

Action	Method	Path	Action id
List Voices	GET	/v3/voices	conn_mod_def::GKhIP7QGFlA::TsT5V841T-uK_RxDezxNMQ
Design a Voice	POST	/v3/voices	conn_mod_def::GKhIP4_diog::msKoxLdlRaKQWuElKnw1Ow
Generate Speech	POST	/v3/voices/speech	conn_mod_def::GKhIP53TRYg::GJE-nBcgSTmJynPWCVvX0w

Avatars

Action	Method	Path	Action id
List Avatar Groups	GET	/v3/avatars	conn_mod_def::GKhIOpLYSiA::f3vpqIzjQs6ptMZReAelTQ
Create Avatar	POST	/v3/avatars	conn_mod_def::GKhIOdwoRNg::H_J9jhPnSTC6PPsug-KU5A

WorkflowExecutions

Action	Method	Path	Action id
Get Workflow Execution Status	GET	/v1/workflows/executions/{{executionId}}	conn_mod_def::GKhIQY7D4qg::g9UbA-iMTiWphLlaKKYRxg
Create a Workflow Execution	POST	/v1/workflows/executions	conn_mod_def::GKhIQPuRivg::MH7UuMWdRr6eJ4cq4yX3UQ

AvatarGroups

Action	Method	Path	Action id
Get an Avatar Group	GET	/v3/avatars/{{groupId}}	conn_mod_def::GKhIOawntcA::E3fQryPFRwyR_qOLO1zS3w

Assets

Action	Method	Path	Action id
Upload Asset	POST	/v3/assets	conn_mod_def::GKhIObHnqhA::x5s9KLOkTwO9e8lEavoCNA

AvatarConsent

Action	Method	Path	Action id
Create Avatar Consent for an Avatar Group	POST	/v3/avatars/{{groupId}}/consent	conn_mod_def::GKhIOcw_Leg::5u9LiKtoQ_uuNciwgF3YKQ

User

Action	Method	Path	Action id
Get Current User Info, Remaining Credits, and Billing	GET	/v1/user/me	conn_mod_def::GKhIO2HUBYA::vAbNfQOQSgW0NEg8-xg2nw

Users

Action	Method	Path	Action id
Get Current User	GET	/v3/users/me	conn_mod_def::GKhIO3RryYA::p8D8kGF_T7OctoAuiuFm0A

VideoAgentSessionResources

Action	Method	Path	Action id
Get a Video Agent Session Resource	GET	/v3/video-agents/{{sessionId}}/resources/{{resourceId}}	conn_mod_def::GKhIPADkknA::Sg3djILtRpWjHRS3K2lcvw

VideoAgent

Action	Method	Path	Action id
Create a Video from a Prompt	POST	/v1/video_agent/generate	conn_mod_def::GKhIPARFHqg::PhC_QHYtQQqG7HYB5Vd43g

VideoAgentSessionsVideos

Action	Method	Path	Action id
List a Video Agent Session's Videos	GET	/v3/video-agents/{{sessionId}}/videos	conn_mod_def::GKhIPAjrs7g::j4wAXE2aTCKKZA3Rk9CMNg

ProofreadSessions

Action	Method	Path	Action id
Create Proofread Session	POST	/v3/video-translations/proofreads	conn_mod_def::GKhIPI2CPMg::uY_gX8YPSV2sTpZd4NsFkw

VideoAgentSessions

Action	Method	Path	Action id
List Video Agent Sessions	GET	/v3/video-agents	conn_mod_def::GKhIPJONsTg::3JuGO_iZSZaBmBjPn60QNQ

VideoAgentStyles

Action	Method	Path	Action id
List Video Agent Styles	GET	/v3/video-agents/styles	conn_mod_def::GKhIPJ319-g::odRJYgPaTl-Uqk8cVYskHA

VideoTranslation

Action	Method	Path	Action id
Create Video Translation	POST	/v2/video_translate	conn_mod_def::GKhIPSY7ksA::-YQHNc2fQGO0S4JCU1t46A

VideoTranslationsLanguages

Action	Method	Path	Action id
List Supported Translation Languages	GET	/v3/video-translations/languages	conn_mod_def::GKhIPbJpj0A::hMAPz_40QNObEnpTCBtsgQ

VideoTranslationProofreadSessions

Action	Method	Path	Action id
Get a Video Translation Proofread Session	GET	/v3/video-translations/proofreads/{{proofreadId}}	conn_mod_def::GKhIPbJ1HEg::i8-SUCPfRMqKi8gRg4Y7zA

VideoTranslateCaption

Action	Method	Path	Action id
Get Video Translate Caption	GET	/v2/video_translate/caption	conn_mod_def::GKhIPbWc5UA::wKtahrg_SkKxZaqsdTOtCg

VideoTranslateLanguages

Action	Method	Path	Action id
List Video Translate Languages	GET	/v2/video_translate/target_languages	conn_mod_def::GKhIPdUAU5A::hlosVeviSCWY-lfG-ll8fA

VideoTranslationsProofreads

Action	Method	Path	Action id
Upload Proofread SRT	PUT	/v3/video-translations/proofreads/{{proofreadId}}/srt	conn_mod_def::GKhIPmU3Ayg::2ZwmTe-_ROuOs_a8gbbeJg

Audio

Action	Method	Path	Action id
Generate Speech Audio From Text	POST	/v1/audio/text_to_speech	conn_mod_def::GKhIP9xFHIg::MF4rIjDeQaitFhXybp15cQ

WebhookEventTypes

Action	Method	Path	Action id
List Webhook Event Types	GET	/v3/webhooks/event-types	conn_mod_def::GKhIQFesMPA::fXaynsDgR7OodnrY6isTOw

AudioVoices

Action	Method	Path	Action id
List Audio Voices	GET	/v1/audio/voices	conn_mod_def::GKhIQHFIZ5A::NV4gkIWJQnOngSv809hrOg

GraphExecutions

Action	Method	Path	Action id
Create a Graph Execution	POST	/v1/workflows/graph-executions	conn_mod_def::GKhIQPYVqHA::bEi8BjJ_Skesz4ZDYC0sPw

WebhookEvents

Action	Method	Path	Action id
List Webhook Events	GET	/v3/webhooks/events	conn_mod_def::GKhIQQfN6bA::pv49TmdmQGSc4URWsPwkvQ

Workflows

Action	Method	Path	Action id
List Available Workflows	GET	/v1/workflows	conn_mod_def::GKhIQX9D9Zg::j0CeYvYwTcKG0Ec-Xn77ew

When a call fails

The error comes from HeyGen, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/hey-gen

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.