Kerux
Start free trial

Via API steps and webhooks No app to install: Kerux talks to HeyGen's API with HTTP steps and webhooks, set up once.

HeyGen avatar videos for each LinkedIn lead

Kerux sends HeyGen a script with the lead's first name and company. HeyGen renders the avatar video and calls back, and the next LinkedIn message sends it.

How it works

  1. A script with his name

    Kerux sends it to HeyGen's API.

  2. The avatar speaks

    Daniel's name, Northwind's challenge.

  3. Sent on LinkedIn

    Right after HeyGen calls back.

An example workflow

  1. Send the LinkedIn invitation.
  2. Accepted: a Call & wait step creates a HeyGen video with your avatar, a script using {{lead.first_name}} and callback_url: {{wait.callback_url}}.
  3. The lead waits until HeyGen reports the video is ready.
  4. A LinkedIn message sends the video link.
  5. A failed render or a timeout sends a plain text message instead.

What data flows

Kerux sends to HeyGen

  • lead.first_name
  • lead.company
  • callback_url

HeyGen sends to Kerux

HeyGen's callback with the video's status and id; the video URL comes from HeyGen's video status endpoint.

Set it up

  1. In HeyGen, copy your API key from the API settings. Kerux sends it in the x-api-key header.
  2. In Kerux, open Integrations > Connections and click Connect on Custom API (under Developers). Pick how HeyGen signs in, paste the key and HeyGen's Base URL, click Save, then Test connection.
  3. Add a Call & wait step: POST /v3/videos with type: "avatar", your avatar_id and voice_id, the script and callback_url: {{wait.callback_url}}.
  4. Run one lead, then pick the video's link from HeyGen's callback or from GET /v3/videos/{id}.
  5. In the campaign's Builder, click Test to open Test on one lead: the lead's journey shows what Kerux sent to HeyGen and what came back.

Plan limits: HeyGen's API is billed separately from its app plans, per video length (HeyGen's API pricing).

Questions

Does Kerux have a native HeyGen integration?

Not a one-click app. Kerux works with HeyGen today through HeyGen's own API: you save your HeyGen key once in Kerux, then HTTP steps and webhooks do the work inside your campaigns. Nothing to install and no Zapier needed.

How long does a video take?

It depends on length and HeyGen's queue, usually minutes. Set the step's time limit to cover it; the lead waits only as long as needed.

Does a script with an empty variable go out?

No. Kerux never sends a step with an empty variable: give the variable a default, or the lead waits for you to fix it.

What happens if HeyGen is down or refuses a call?

The lead stops with HeyGen's own error message and shows in Need attention with a Retry button. It never shows as finished because a call failed, and nothing else goes out to that lead until you decide.

Use it in a campaign

Try Kerux free for 10 days. No card needed.

Related integrations