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
A script with his name
Kerux sends it to HeyGen's API.
The avatar speaks
Daniel's name, Northwind's challenge.
Sent on LinkedIn
Right after HeyGen calls back.
An example workflow
- Send the LinkedIn invitation.
- Accepted: a Call & wait step creates a HeyGen video with your avatar, a script using
{{lead.first_name}}andcallback_url: {{wait.callback_url}}. - The lead waits until HeyGen reports the video is ready.
- A LinkedIn message sends the video link.
- A failed render or a timeout sends a plain text message instead.
What data flows
Kerux sends to HeyGen
lead.first_namelead.companycallback_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
- In HeyGen, copy your API key from the API settings. Kerux sends it in the
x-api-keyheader. - 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.
- Add a Call & wait step: POST
/v3/videoswithtype: "avatar", youravatar_idandvoice_id, thescriptandcallback_url: {{wait.callback_url}}. - Run one lead, then pick the video's link from HeyGen's callback or from GET
/v3/videos/{id}. - 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.
