Next.js + Mailchimp integration

Mailchimp connects to the checkout, not to Next.js. Your app loads the Plandalf SDK and opens the offer; a Plandalf sequence then runs native Mailchimp steps: add or update the contact, add tags, record an event. Mailchimp subscribe events can start a Plandalf sequence.

1. Load the SDK in a client provider

   Use next/script inside a 'use client' component and wait for plandalf('ready', ...). Never read window during server rendering.

2. Render a button or inline checkout

   Use data-plandalf-present for a modal or sdk.mount() in an effect for an inline form, and return the handle's close() from the effect cleanup.

3. Create the Mailchimp key

   Mailchimp's Extras menu has API keys. Create one and copy it whole, including the -us21 style suffix.

4. Connect and add the contact

   Connect Mailchimp under Automation, Marketplace. On a Checkout Completed sequence add Mailchimp, Add or Update Contact with your Audience and {{trigger.customer_email}}. Create any merge field in Mailchimp first.

5. Record the event and build the journey

   Add Record Event named plan_purchased with a plan property from {{trigger.line_items_summary}}. In Mailchimp start a Customer Journey on that event name.

6. Test, then switch off test runs

   Enable Run on test purchases, buy with a Stripe test card, check the contact in the audience, then turn the option off.

• Mailchimp events carry no revenue and are not Mailchimp orders. Put the amount into a property if reports need it.
• Existing contacts keep their status, so a step never resubscribes someone who unsubscribed.
• Signed customer identity in Next.js prefills the checkout. It does not by itself guarantee which email the sequence sees, so test with a logged-in user.
• Mailchimp permits 10 simultaneous connections per key, and Plandalf retries twice before a step fails.
• Your server, not a Mailchimp tag, should decide who gets paid access.

Does Next.js integrate with Mailchimp?

Through Plandalf rather than directly. The Next.js app opens the checkout, and Plandalf's native Mailchimp steps handle the audience, tags and events.

How do I add Next.js customers to a Mailchimp audience?

Connect Mailchimp with an API key under Automation, then add Add or Update Contact to a sequence that starts on Checkout Completed for your offer.

Why is the Mailchimp Record Event not starting my journey?

The event name must match the journey's starting point exactly, including the underscores Plandalf adds in place of spaces. Check the run's Events view for the name that was sent.

Checked October 26, 2026 against Plandalf's own setup guides and the vendor documentation: Next.js: load and optimize scripts.