HeyGen icon

HeyGen

HeyGen community node — videos, voices, avatars, video agent, lipsync, assets

Actions23

List → List Avatars

AI-generated

Summary

Lists HeyGen avatar looks through the v3 API. Use the filters to narrow the results; supply the next-page token from a previous response to continue pagination.

Inputs

  • Authentication (required) — Choose OAuth2 (default) or the legacy API key method and configure the matching HeyGen credential.
  • Max Results — Maximum number of looks to request per page; defaults to 20.
  • Pagination Token — Opaque cursor from a previous response’s next_token, used to fetch another page.
  • Group ID — Limit results to looks in this avatar group; surrounding whitespace is trimmed.
  • Avatar Type — Filter by Digital Twin, Photo Avatar, or Studio Avatar. Any is the default and sends no type filter.
  • Ownership — Filter by Private or Public ownership. Any is the default and sends no ownership filter.

Output shape

One output item per input item, with the HeyGen API response in its json field.

Returns the response from GET /v3/avatars/looks, including pagination data when provided by the API. With Continue On Fail enabled, an item that errors instead contains an error message.

Links

Discussion