HeyGen
for LuumenAI

Read your HeyGen avatars, assets, and sessions, then create video with approval

Connect HeyGen and Luumen can see your avatar groups, voices, knowledge bases, folders, assets, and streaming session history without you opening the dashboard. Ask what exists, what a training job is doing, or which looks are in a group. When you want something made or removed, the agent shows the call first and waits for your approval.

Book a DemoDownload Luumen

The HeyGen toolbox

71 tools: 32 read, 39 write. Reads answer instantly. Writes require approval by default. Everything is logged.

  • ReadCheck photo/look generation statusRetrieve the current status and details of a photo avatar or look generation by its ID.
  • ReadGet current user informationRetrieve the profile information of the currently authenticated user.
  • ReadGet training job statusRetrieve the current training status and details of a photo avatar training job by group ID.
  • ReadList all avatar groupsRetrieve a list of all available avatar groups in your HeyGen account.
  • ReadList all locales for voicesRetrieve available locales for multilingual voices.
  • ReadList assetsRetrieve a paginated list of all assets (images, audios, videos) created under your account.
  • ReadList brand voicesRetrieve a list of brand glossaries created under your account.
  • ReadList foldersRetrieve a paginated list of folders created under your account.
  • ReadList avatars in a specific groupRetrieve all avatars that belong to a specific avatar group.
  • ReadList knowledge basesRetrieve a list of all existing knowledge bases associated with your account.
  • ReadList session historyRetrieve a paginated history of all streaming sessions with metadata including session duration, timestamps, and other details.
  • ReadList streaming avatarsRetrieve a list of public and custom interactive avatars for streaming.
  • ReadList TTS voicesRetrieve a list of public and custom voices compatible with HeyGen's Starfish TTS model.
  • ReadFetch personalized video project detailRetrieves detailed information about a specific personalized video project in HeyGen, including status, settings, and metadata.
  • ReadGet photo avatar detailsRetrieve detailed information about a photo avatar or look using its unique ID.
  • ReadRetrieve avatar detailsRetrieve detailed information about a specific avatar by its ID.
  • ReadRetrieve template details v3Retrieve comprehensive details about a specific template including all available variables for replacement and scene mappings for templates built in the New AI Studio.
  • ReadRetrieve video status detailsRetrieve the current processing status and metadata for a specific video by ID.
  • ReadSearch public avatar groupsSearch and retrieve public avatar groups with optional filters and pagination.
  • ReadRetrieve streaming listRetrieves a list of active or available streaming sessions or content within the HeyGen platform.
  • ReadList avatars endpointRetrieves a list of available avatars from the Heygen platform.
  • ReadList talking photo entriesRetrieves a list of talking photos created using the HeyGen platform.
  • ReadList videosRetrieves a list of videos associated with the user's account on the HeyGen platform.
  • ReadList voice endpointsRetrieves a comprehensive list of all available voices in the HeyGen platform.
  • ReadList webhook endpointsRetrieves a list of all webhook endpoints configured for your HeyGen account.
  • ReadList webhooksRetrieves a list of all available webhook event types that can be subscribed to in your HeyGen account.
  • ReadGet template by idRetrieves a specific template from the HeyGen platform using its unique identifier.
  • ReadRetrieve all templatesRetrieves a list of available avatar templates from the HeyGen platform.
  • ReadRetrieve user remaining quotaRetrieves the current remaining quota for the authenticated user on the HeyGen platform.
  • ReadRetrieve video translation by idRetrieves the current status of a video translation job in the HeyGen platform.
  • ReadRetrieve video translation target languagesRetrieves a list of all available target languages supported by HeyGen's video translation feature.
  • ReadList available voicesRetrieves a list of available voice models and options that can be used with HeyGen's AI-driven video creation platform.
  • WriteAdd looks to photo avatar groupAdd additional looks (images) to an existing photo avatar group. Approval by default
  • WriteAdd motion to photo avatarAdd natural motion or animation to an existing photo avatar, turning a still image into a moving, lifelike one. Approval by default
  • WriteCreate a new folderCreate a new folder under your HeyGen account. Approval by default
  • WriteCreate knowledge baseCreate a new knowledge base with a specified name, opening line, and custom prompt for Interactive Avatar streaming sessions. Approval by default
  • WriteCreate photo avatar groupCreate an avatar group which can include both AI-generated and user-uploaded photos of the avatar. Approval by default
  • WriteCreate WebM videoCreate a WebM format video with transparent background featuring an avatar speaking text or audio. Approval by default
  • WriteDelete an avatar videoDelete a video by its ID from HeyGen account. Approval by default
  • WriteDelete assetDelete a specific asset by its unique asset ID from HeyGen account. Approval by default
  • WriteDelete knowledge baseDelete a specific knowledge base by its ID. Approval by default
  • WriteDelete photo avatarDelete a photo avatar by its ID from HeyGen account. Approval by default
  • WriteDelete photo avatar groupDelete a photo avatar group by its ID from HeyGen account. Approval by default
  • WriteDelete webhook endpointPermanently delete a webhook endpoint from HeyGen. Approval by default
  • WriteGenerate photo avatar photosGenerate a personalized AI avatar based on text prompts and attribute inputs. Approval by default
  • WriteGenerate text-to-speech audioGenerate a speech audio file from any text input using a specified voice, powered by HeyGen's Starfish model. Approval by default
  • WriteGenerate voice audio previewGenerate a short audio preview with the specified voice and text. Approval by default
  • WriteKeep alive streaming sessionReset the idle timeout counter for an active streaming session. Approval by default
  • WriteCreate new streaming sessionInitiate a new streaming session with an Interactive Avatar for real-time interactions. Approval by default
  • WriteAdd contact to personalized video projectThis endpoint allows you to add one or more contacts to a specific personalized video project in the Heygen platform. Approval by default
  • WritePost talking photo binary imageCreates a talking photo by processing an uploaded image file. Approval by default
  • WriteRestore folder from trashRestore a previously deleted folder from trash by its unique folder ID. Approval by default
  • WriteRetrieve sharable video URLGenerate a public, shareable URL for a specific video by ID. Approval by default
  • WriteCreate streaming token with expiryCreates a new streaming token for use with HeyGen's real-time avatar and voice chat services. Approval by default
  • WritePost streaming ice candidatesThis endpoint is used to submit ICE (Interactive Connectivity Establishment) candidate information for a specific streaming session in the Heygen platform. Approval by default
  • WriteInterrupt streaming sessionInterrupts an ongoing streaming session with an interactive avatar. Approval by default
  • WriteSet streaming quality endpointInitiates a new streaming session with HeyGen, allowing users to start an avatar-based stream with specified quality settings. Approval by default
  • WriteStart streaming sessionInitiates a new streaming session for real-time communication in the HeyGen platform. Approval by default
  • WriteStop streaming sessionThe streaming.stop endpoint is used to terminate an active streaming session in the Heygen API. Approval by default
  • WriteSend task to streaming avatarThe StreamingTask endpoint initiates a real-time speaking task for an AI-driven avatar within an active streaming session. Approval by default
  • WriteMove folder to trashMove a specific folder to trash by its unique folder ID. Approval by default
  • WriteUpdate folder nameUpdate (rename) an existing folder by its unique folder ID. Approval by default
  • WriteUpdate knowledge baseUpdate an existing knowledge base by its ID. Approval by default
  • WriteUpdate webhook endpointModify an existing webhook endpoint configuration including URL and subscribed event types. Approval by default
  • WriteUpload assetUpload a file asset (image, video, or audio) to HeyGen platform. Approval by default
  • WriteUpscale motion avatarEnhance the resolution and visual quality of a motion avatar. Approval by default
  • WriteAdd webhook endpointAdds a new webhook endpoint to receive real-time notifications for specified Heygen events. Approval by default
  • WriteDelete talking photo by idDeletes a specific talking photo from the HeyGen platform using its unique identifier. Approval by default
  • WriteGenerate video template with variablesGenerates a customized video from a pre-existing template using HeyGen's AI platform. Approval by default
  • WriteGenerate video with inputsGenerates a customized video using Heygen's AI-driven platform. Approval by default
  • WritePost video translate requestThe TranslateVideo endpoint enables the translation of video content from one language to another. Approval by default

One prompt, start to finish

What a governed HeyGen run looks like inside Luumen.

Questions

How does LuumenAI connect to HeyGen?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

Can LuumenAI change things in HeyGen on its own?

Read actions answer immediately. Anything that writes — add looks to photo avatar group, add motion to photo avatar, create a new folder, create knowledge base, and more — is shown as a plan and requires approval by default, including the 10 actions classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.

Who gets access to the integration?

You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.

Is there an audit trail?

Every call to HeyGen — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.

All integrations
Adobe Marketing Agent MCPAdobe Experience Platform context, sandbox switches, and async task statusAffindaRead parsed documents, collections, and annotations — change them with approvalAgent MailGive the agent its own mailbox for reading threads and sending updatesAI/ML APIInspect assistants, threads, and runs — and change them as approved steps

Put HeyGen to work with Luumen

Connect in minutes. Every action scoped, approved, and audited from day one.

Book a DemoDownload Luumen