Skip to content
One platform. From customer conversation to completed work.Take a closer look
All connections
Media ยท CONNECTION

HeyGen + NodeHub

Track and manage HeyGen videos, avatars, voices, templates, assets, brand kits and jobs.

Explore 103 workflow actions for HeyGen, including account permissions and operation limits.

74 read actions29 write actions
WORKFLOW ACTIONS

What you can configure.

Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.

Bulk Asset Statuses

Read

Returns statuses for up to 100 assets by assetids and/or batchids: queued, processing, completed, failed, or notfound.

Permissions and limits

Account permissions

  • A HeyGen API key

Bulk Lipsync Statuses

Read

Returns statuses for up to 100 lipsyncs by lipsyncids and/or batchids: queued, processing, completed, failed, or notfound.

Permissions and limits

Account permissions

  • A HeyGen API key

Bulk Video Statuses

Read

Returns statuses for up to 100 videos in one request, addressed by comma-separated videoids and/or batchids query params.

Permissions and limits

Account permissions

  • A HeyGen API key

Bulk Video Translation Statuses

Read

Returns statuses for up to 100 video translations by videotranslationids and/or batchids: queued, processing, completed, failed, or notfound.

Permissions and limits

Account permissions

  • A HeyGen API key

Create Brand Glossary

Write

Creates a brand glossary.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Create Brand Kit

Write

Creates a brand kit by importing logos, colors and fonts from a public website; by calling it you confirm you have the rights to use those assets.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Create Folder

Write

Creates a folder at the root or inside parentid.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Create Template from Video

Write

Creates a private template from one of your videos, copying its scenes, avatars, script and media.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Delete a Voice

Write

Deletes a voice clone you own and frees its place in your clone limit.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Delete AI Clipping

Write

Soft-deletes an AI clip job and its clips.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Delete an Audio Voice

Write

Deletes the caller-owned model-backed audio voice.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Delete Asset

Write

Permanently deletes an asset.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Delete Avatar Group

Write

Permanently deletes an avatar group and all its associated looks.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Delete Avatar Look

Write

Deletes an avatar look.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Delete Background Removal

Write

Soft-deletes a background removal job.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Delete Brand Glossary

Write

Deletes a brand glossary.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Delete Brand Kit

Write

Deletes a brand kit and its colors, logos and fonts.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Delete HyperFrames Render

Write

Soft-deletes a HyperFrames render.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Delete Lipsync

Write

Permanently deletes a lipsync job and its associated files.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Delete Podcast

Write

Soft-deletes a podcast so it no longer appears in the get/list endpoints.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Delete Proofread Session

Write

Deletes a proofread session, removing it from listings and from the workspace's projects.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Delete Template

Write

Soft-deletes a template.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Delete Video

Write

Permanently deletes a video and its associated files.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Delete Video Translation

Write

Permanently deletes a video translation and its associated files.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Get AI Clipping

Read

Returns the full job resource including produced clips, statuses, and presigned download URLs.

Permissions and limits

Account permissions

  • A HeyGen API key

Get an Audio Voice

Read

Returns one model-backed audio voice, owned by the caller's workspace or public, and its current lifecycle state.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Asset

Read

Returns metadata for an asset in the caller's workspace , including owner, upload timestamp, file type, and a publicly accessible URL.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Asset Batch

Read

Returns batch aggregate status and one page of items with their ids and statuses.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Avatar Group

Read

Returns details for a specific avatar group including name, gender, preview URLs, looks count, and training status.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Avatar Look

Read

Returns details for a specific avatar look including supported engines, preferred orientation, preview URLs, and training status.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Background Removal

Read

Returns a background removal job including its status and, once completed, presigned download URLs for the produced layers.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Brand Glossary

Read

Returns one brand glossary with its full term list.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Brand Kit

Read

Returns one brand kit with its colors, logos and fonts and the role each plays.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Current API Key

Read

Returns non-secret metadata, expiration, and permission scopes for the API key used to authenticate this request.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Current User

Read

Returns the authenticated user's profile, remaining credits or balance, and billing details.

Permissions and limits

Account permissions

  • A HeyGen API key

Get current user info, remaining credits, and billing

Read

Returns the authenticated user's profile, remaining credits or balance, and billing details.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Custom Agent

Read

Returns metadata for a single custom agent.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Custom Agent Video Status

Read

Returns status + presigned output MP4 URL once the workflow completes.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Filler Word Removal

Read

Returns the job resource: lifecycle status, progress, and , once completed , the presigned download URL of the cleaned video plus removal statistics (numcuts, reductionpct, durations).

Permissions and limits

Account permissions

  • A HeyGen API key

Get Folder

Read

Returns one folder in your workspace, including one in the trash (istrash).

Permissions and limits

Account permissions

  • A HeyGen API key

Get HeyGen Image

Read

Return the generation job status and ordered images with fresh download URLs once the entire job completes.

Permissions and limits

Account permissions

  • A HeyGen API key

Get HeyGen Video

Read

Returns a HeyGen Video generation: pending, processing, completed, failed or cancelled.

Permissions and limits

Account permissions

  • A HeyGen API key

Get HyperFrames Render

Read

Returns full details for a single HyperFrames render, including status and signed videourl when complete.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Image

Read

Return a generation created by POST /v3/images: its images with fresh download URLs once completed, its failure code once failed, or pending while the creating request is still running.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Lipsync

Read

Returns details for a lipsync job including status, videourl, captionurl, and failure info if applicable.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Lipsync Batch

Read

Returns batch aggregate status and one page of items with their ids and statuses.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Music

Read

Return a music job created by POST /v3/audio/music: a fresh audiourl once completed, its failure code once failed, or pending while the creating request is still running.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Podcast

Read

Returns a podcast's status and, once completed, its videourl, thumbnailurl, and duration.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Proofread Session

Read

Returns the status and details of a proofread session.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Template

Read

Returns template details including its variable schema (with current default values) and scenes.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Transcription

Read

Return a transcription created by POST /v3/audio/transcriptions: its transcript once completed, its failure code once failed, or pending while the creating request is still running.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Video

Read

Returns details for a video including status, videourl, thumbnailurl, duration, and failure info if applicable.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Video Agent Session

Read

Returns the current status, progress, videoid, and recent chat messages for a session.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Video Batch

Read

Returns batch aggregate status and one page of items with their video ids and statuses.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Video Generation

Read

Return a generation created by POST /v3/video-generations: pending while the model works, completed with a fresh videourl to the mp4, or failed with its failure code.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Video Quality Comparison

Read

Return the latest state and result or terminal error for one comparison.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Video Quality Comparison Batch

Read

Return aggregate batch status and one cursor-paginated page of comparison items.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Video Scenes

Read

Returns a video's scenes as it stands now, with the editversion to send when editing.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Video Translation

Read

Returns details for a translation job including status, output language, videourl, and failure info if applicable.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Video Translation Batch

Read

Returns batch aggregate status and one page of items with their ids and statuses.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Voice

Read

Returns details for a specific voice, including clone workflow status when available.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Workflow

Read

Returns a single workflow definition, including its current mutable draft graph.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Workflow Run

Read

Returns a workflow run: its pinned version, timestamps, node progress, any terminal error and every declared output.

Permissions and limits

Account permissions

  • A HeyGen API key

Get Workflow Version

Read

Returns a single immutable, compiled workflow version, including its full plan summary.

Permissions and limits

Account permissions

  • A HeyGen API key

List AI Clipping

Read

Returns a cursor-paginated list of AI clip jobs in the authenticated user's workspace, newest first.

Permissions and limits

Account permissions

  • A HeyGen API key

List Assets

Read

Beta: may change with a few days' notice.

Permissions and limits

Account permissions

  • A HeyGen API key

List Audio Voices

Read

Returns model-backed audio voices, ordered newest first.

Permissions and limits

Account permissions

  • A HeyGen API key

List Avatar Groups

Read

Returns a paginated list of avatar groups (characters).

Permissions and limits

Account permissions

  • A HeyGen API key

List Avatar Looks

Read

Returns a paginated list of avatar looks (outfits, poses, styles).

Permissions and limits

Account permissions

  • A HeyGen API key

List Background Removals

Read

Returns a paginated list of background removal jobs for the account, newest first.

Permissions and limits

Account permissions

  • A HeyGen API key

List Brand Glossaries

Read

Lists the brand glossaries in your workspace.

Permissions and limits

Account permissions

  • A HeyGen API key

List Brand Kits

Read

Returns brand kits available in the authenticated user's workspace.

Permissions and limits

Account permissions

  • A HeyGen API key

List Custom Agents

Read

Returns the installed custom agents.

Permissions and limits

Account permissions

  • A HeyGen API key

List HyperFrames Renders

Read

Returns a cursor-paginated list of HyperFrames renders in the account, newest first.

Permissions and limits

Account permissions

  • A HeyGen API key

List Lipsyncs

Read

Returns a paginated list of all lipsync jobs in the account.

Permissions and limits

Account permissions

  • A HeyGen API key

List Look Templates

Read

Lists the look templates and Look Packs your workspace can apply with POST /v3/avatars/looks.

Permissions and limits

Account permissions

  • A HeyGen API key

List Podcasts

Read

Returns a paginated list of the podcasts in the authenticated workspace, newest first.

Permissions and limits

Account permissions

  • A HeyGen API key

List Proofread Sessions

Read

Returns a paginated list of all proofread sessions in the workspace, newest first.

Permissions and limits

Account permissions

  • A HeyGen API key

List Session Videos

Read

Returns all videos produced within a Video Agent session, sorted newest-first.

Permissions and limits

Account permissions

  • A HeyGen API key

List Supported Translation Languages

Read

Returns all supported target language names for video translation.

Permissions and limits

Account permissions

  • A HeyGen API key

List Templates

Read

Returns a paginated list of API-ready templates in the workspace.

Permissions and limits

Account permissions

  • A HeyGen API key

List Video Agent Sessions

Read

Returns a paginated list of video agent sessions for the authenticated user, sorted newest-first.

Permissions and limits

Account permissions

  • A HeyGen API key

List Video Agent Styles

Read

Returns curated visual style templates available for Video Agent sessions.

Permissions and limits

Account permissions

  • A HeyGen API key

List Video Translations

Read

Returns a paginated list of all video translation jobs in the account.

Permissions and limits

Account permissions

  • A HeyGen API key

List Videos

Read

Returns a paginated list of all videos in the account.

Permissions and limits

Account permissions

  • A HeyGen API key

List Voices

Read

Returns a paginated list of voices, filterable by type, engine, language, and gender.

Permissions and limits

Account permissions

  • A HeyGen API key

List Webhook Event Types

Read

Returns all available webhook event types with human-readable descriptions.

Permissions and limits

Account permissions

  • A HeyGen API key

List Workflow Node Types

Read

Discovery catalog of authorable node types, grouped by family with per-variant config schema and ports.

Permissions and limits

Account permissions

  • A HeyGen API key

List Workflow Run Nodes

Read

Paginated per-node diagnostics for one run: node id, status, timestamps, and a sanitized error for failed nodes.

Permissions and limits

Account permissions

  • A HeyGen API key

List Workflow Runs

Read

Returns a paginated list of runs for the workflow named by the required workflowid query parameter, newest first.

Permissions and limits

Account permissions

  • A HeyGen API key

List Workflow Versions

Read

Returns a paginated list of immutable, compiled versions for a workflow definition.

Permissions and limits

Account permissions

  • A HeyGen API key

List Workflows

Read

Returns a paginated list of workflow definitions.

Permissions and limits

Account permissions

  • A HeyGen API key

Search assets (images and icons)

Read

Semantically search re-hosted public images and icons by natural-language description, e.g.

Permissions and limits

Account permissions

  • A HeyGen API key

Search audio (music or sound effects)

Read

Searches the music or sound-effects catalog by natural-language description (type=music by default, or soundeffects).

Permissions and limits

Account permissions

  • A HeyGen API key

Set Template Variables

Write

Replaces a template's full set of variables: any variable you omit is removed.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Update Avatar Group

Write

Updates an avatar group you own.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Update Avatar Look

Write

Updates the display name of an avatar look.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Update Brand Glossary

Write

Updates a brand glossary.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Update Brand Kit

Write

Updates a brand kit's name or role assignments: color roles, main logo, heading and body fonts.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Update Lipsync

Write

Updates the display title of a lipsync job.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Update Template

Write

Renames a template.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Update Video Translation

Write

Updates the display title of a video translation job.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

Update Workflow Draft

Write

Replaces the mutable draft product graph.

Permissions and limits

Account permissions

  • A HeyGen API key

A repeated request may repeat the external action. Review the previous result before retrying a write.

SETUP

Start with a controlled test.

01Connect the intended account

Use the account and permissions required for your process. Review the connection check before configuring a workflow action.

02Review inputs and access

Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.

03Confirm the result

Inspect step outputs and confirm the result in HeyGen. A saved workflow is not a completed provider action.

Follow the workflow quickstart
EXPLORE YOUR STACK

More in Media.

HeyGen integration | NodeHub