HeyGen Pro icon

HeyGen Pro

Create and monitor HeyGen avatar, template, and Video Agent videos

Actions8

Video → List Avatar Looks

AI-generated

Summary

Lists HeyGen avatar looks, optionally filtered by avatar type, and returns each look as a separate n8n item. Results are fetched in pages and cached in memory for five minutes unless Refresh Cache is enabled.

Inputs

  • Avatar Type — Choose All Avatar Types (the default), Studio Avatar, Digital Twin, or Photo Avatar to filter the list.
  • Refresh Cache — Defaults to true and bypasses the five-minute in-memory cache. Set false to reuse cached results for the selected avatar type when available.

Output shape

A list of items, one per avatar look, with each look returned as its JSON data.

An empty result produces no items. Each output item is paired with the input item that triggered the listing. HeyGen API errors are raised unless the node is configured to continue on fail.

Examples

Example 1: Retrieve current Digital Twin looks

Set Avatar Type to Digital Twin and leave Refresh Cache enabled.

Links

Discussion