Via API steps and webhooks No app to install: Kerux talks to Mailchimp's API with HTTP steps and webhooks, set up once.
From LinkedIn to your Mailchimp audience
When a LinkedIn lead with an email is ready for your newsletter or a Customer Journey, an API step adds or updates them in your Mailchimp audience with their name and a tag.
How it works
Daniel accepts
He's a new connection with an email.
Member added
With his name and the tag you chose.
Your journey starts
Mailchimp sends the welcome series.
An example workflow
- LinkedIn invitation, then a first message when it's accepted.
- A Condition checks that the lead has an email.
- A Webhook / HTTP step PUTs the member in your audience (add or update) with
status_if_newand merge fields. - A second step adds the
linkedintag, which starts your Mailchimp Customer Journey. - LinkedIn follow-ups continue until the lead replies.
What data flows
Kerux sends to Mailchimp
emaillead.first_namelead.last_name
Mailchimp sends to Kerux
idstatus
Set it up
- In Mailchimp, create an API key under Profile > Extras > API keys. Kerux signs in with it as the password of Username and password (any username).
- In Kerux, open Integrations > Connections and click Connect on Custom API (under Developers). Pick how Mailchimp signs in, paste the key and Mailchimp's Base URL, click Save, then Test connection.
- Use your data center in the Base URL, for example
https://us21.api.mailchimp.com/3.0(the part after the dash in your key). - Add a Webhook / HTTP step: PUT
/lists/{list_id}/members/{{email}}withemail_address,status_if_newandmerge_fields. Mailchimp accepts the email in place of the member's hash. - Add the tag with a second step: POST
/lists/{list_id}/members/{{email}}/tagswith{"tags": [{"name": "linkedin", "status": "active"}]}. - In the campaign's Builder, click Test to open Test on one lead: the lead's journey shows what Kerux sent to Mailchimp and what came back.
Plan limits: Mailchimp's Marketing API is on all plans, including free; Customer Journeys and audience limits depend on the plan (Mailchimp's pricing).
Questions
Does Kerux have a native Mailchimp integration?
Not a one-click app. Kerux works with Mailchimp today through Mailchimp's own API: you save your Mailchimp key once in Kerux, then HTTP steps and webhooks do the work inside your campaigns. Nothing to install and no Zapier needed.
Why PUT and not POST?
PUT adds the member if they're new and updates them if they exist, so a second run never fails with "already a member". POST to /members works too but refuses existing members.
Do I need the MD5 hash of the email?
No. Mailchimp's member endpoints take the hash, the email address or the contact id in the URL (Mailchimp's API reference), so Kerux can use the lead's email directly.
What happens if Mailchimp is down or refuses a call?
The lead stops with Mailchimp'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.