View as Markdown
HeyGen icon

HeyGen ACTION

Retrieve Video Link

Fetches a link for a specific heygen video. The link is only available once the video status is completed. Works for any video ID, including videos created in the HeyGen web app. If you don't have the video ID, use the List Videos action first (note it may not list web-app videos). Example: Video ID v_123 returns {"data": {"id": "v_123", "status": "completed", "video_url": "https://..."}, "video_link": "https://..."}; while the video is still processing, video_link is null and data.status is processing (check again later). If generation failed, data.status is failed, video_link is null, and failure_code and failure_message explain why; the video will never complete, so do not keep polling. See the documentation
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's HeyGen account once, then configure and run Retrieve Video Link from your backend or agent.

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Retrieve Video Link inputs
Property Type Description
videoId Video ID string
Identifier of a specific heygen video. Use the List Videos action to find video IDs. Example: 276970c8cf104bf0bf8fdfd679ea899d
Required

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
heygen-retrieve-video-link
Version
1.0.0
App
HeyGen
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes