Skip to main content
Where to find this: Shopify admin → Apps → Yuko Loyalty → Integrations → Mailchimp

Introduction

The Mailchimp integration sends Yuko data into one Mailchimp audience:
  1. Profile fields: Yuko adds its own merge fields to the audience (for example Yuko Points Balance and Yuko VIP Tier) and fills them in for each customer. Use them to segment the audience and personalise emails.
  2. Events: Yuko posts the loyalty events you choose, such as Earn Points or VIP Tier Upgrade, to the customer’s member record. Use them to start Mailchimp customer journeys.
Data only goes one way, from Yuko to Mailchimp.

When to use

  • Mailchimp is your main email tool.
  • You want segments based on points balance, VIP tier or referral details.
  • You want loyalty events to start Mailchimp customer journeys.

Before you start

Yuko app is installed on your Shopify store — see Install Yuko on Shopify.
The Yuko Theme App Embed is enabled in your active theme — see Theme App Embed.
Your loyalty program is enabled under Loyalty Program Status at Shopify admin → Apps → Yuko Loyalty → Loyalty → Programs.
Your point labels are set in Loyalty Settings.
You have a Mailchimp account with at least one audience. Yuko can’t connect if the account has no audience.
You have a Mailchimp API key. Create one in Mailchimp under Profile → Extras → API keys.
A Mailchimp API key ends with your account’s data center, for example -us21. Paste the whole key, including that ending. Yuko uses it to reach your Mailchimp account, so a key without it can’t connect.

Connect Mailchimp

1

Open the Mailchimp integration

Go to Apps → Yuko Loyalty → Integrations, pick the Email & SMS category and click Mailchimp.
2

Enter your API key

Paste the key into API Key and click Connect Integration. Yuko checks the key and loads your audiences.
3

Choose an audience

In the Audience section, select an audience and click Save. If you’ve just created an audience in Mailchimp, click Refresh audience to reload the list.
4

Wait for the profile fields

After you save an audience, Yuko creates its profile fields in it as a Mailchimp batch operation. This runs in the background and can take a few minutes. The badge next to Mailchimp audience shows Profile fields not ready until it finishes. Click the refresh icon next to the badge to check again. When it shows Profile fields ready, continue.
5

Choose events

Under Events to send to Mailchimp, tick the events you want, or use Select All, then click Save. The event list only appears once the profile fields are ready.
6

Send test events (optional)

Click Send Test Events, then confirm. Yuko sends one sample event for each event you’ve ticked to your audience, so you can check them in Mailchimp.

Profile fields

Yuko adds these merge fields to your audience. It also fills in Mailchimp’s built-in FNAME and LNAME fields with the customer’s first and last name. Use the tag in Mailchimp merge tags, for example *|YK_PTSBAL|* to show the points balance in an email. The fields are refreshed each time Yuko sends one of your selected events for the customer. Fields for a module you’ve turned off, such as Referral, aren’t filled in.

Events

Yuko posts each selected event to the customer’s member record in your audience. Mailchimp event names only allow letters, numbers, underscores and dashes, so Yuko sends the event title with a YK_ prefix and underscores instead of spaces. For example: The event list and the event properties are the same as for Klaviyo. See Klaviyo trigger events for every event and its properties. Mailchimp stores event properties as text, so Yuko sends numbers and dates as text, true/false for yes/no values, and lists as comma-separated text.

How customers are added

  • Each event first adds or updates the customer as a member of your audience, matched by email address. Customers without an email address aren’t sent.
  • Customers who aren’t in the audience yet are added as transactional members. They aren’t subscribed to your marketing emails, so they don’t receive Mailchimp campaigns unless they opt in.
  • Existing members keep their current subscription status. Yuko only updates their merge fields and adds the event.
  • Customers are only added when Yuko sends an event for them. There’s no bulk sync of existing customers to Mailchimp.

Change or disconnect

  • Change audience: select another audience and click Save. Yuko creates its profile fields in the new audience, and events go there from then on.
  • Disconnect: switch off the toggle in the Connection section and confirm Disconnect. Your audience, events and field setup in Yuko are cleared. The YK_ merge fields stay in your Mailchimp audience; if you reconnect, Yuko reuses them and only creates any that are missing.

Best practices

Wait for Profile fields ready before testing. Events can only be chosen, and merge fields only filled in, once the fields exist in the audience.
Turn off Yuko’s own email for the same moment if a Mailchimp journey sends it, so customers don’t get two emails.
Add fallbacks in Mailchimp merge tags for customers whose fields are still empty.

FAQs

Check that you copied the whole key, including the data center at the end (for example -us21), and that the key hasn’t been revoked in Mailchimp. Also check that your Mailchimp account has at least one audience.
The batch operation can take a few minutes. Click the refresh icon next to the badge to check again. If it stays not ready, select the audience and click Save again to retry.
It only appears after you’ve saved an audience and its profile fields are ready.
No. New members are added as transactional, not subscribed. They only receive campaigns if they subscribe.
No. Yuko sends to the one audience you’ve selected.

REST API

Read and write Yuko data programmatically.

Webhooks

Receive real-time event notifications.

Shopify Flow

Trigger Shopify Flow workflows from Yuko loyalty, VIP and referral events.

Shopify POS

Redeem points and apply loyalty discounts at the till.

Klaviyo

Sync customers, points and tier data into Klaviyo.

Mailchimp

Sync loyalty merge fields and events into a Mailchimp audience.

Omnisend

Sync loyalty data into Omnisend.

WhatsApp

Send transactional loyalty messages via 14 supported WhatsApp Business API providers.

Retainful

Email marketing & abandoned cart recovery.

Judge.me

Award loyalty points for Judge.me reviews.

Return Prime

Refund approved returns as loyalty points.

Book a Free Setup Call

Talk to our team for personalised setup help.Time: 30 minutes

Contact Support

Visit our support hub for help articles, live chat and ticket submission.

Browse the Guides

Documentation across loyalty, referrals, memberships and more.

Install Yuko

Add Yuko to your Shopify store from the Shopify App Store.