Kerux
Start free trial

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

  1. Daniel accepts

    He's a new connection with an email.

  2. Member added

    With his name and the tag you chose.

  3. Your journey starts

    Mailchimp sends the welcome series.

An example workflow

  1. LinkedIn invitation, then a first message when it's accepted.
  2. A Condition checks that the lead has an email.
  3. A Webhook / HTTP step PUTs the member in your audience (add or update) with status_if_new and merge fields.
  4. A second step adds the linkedin tag, which starts your Mailchimp Customer Journey.
  5. LinkedIn follow-ups continue until the lead replies.

What data flows

Kerux sends to Mailchimp

  • email
  • lead.first_name
  • lead.last_name

Mailchimp sends to Kerux

  • id
  • status

Set it up

  1. 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).
  2. 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.
  3. 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).
  4. Add a Webhook / HTTP step: PUT /lists/{list_id}/members/{{email}} with email_address, status_if_new and merge_fields. Mailchimp accepts the email in place of the member's hash.
  5. Add the tag with a second step: POST /lists/{list_id}/members/{{email}}/tags with {"tags": [{"name": "linkedin", "status": "active"}]}.
  6. 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.

Related integrations