Where to find this: Shopify admin → Apps → Yuko Loyalty → Integrations → Mailchimp
Introduction
The Mailchimp integration sends Yuko data into one Mailchimp audience:- 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.
- 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.
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 aYK_ 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
FAQs
Connecting fails with my API key. Why?
Connecting fails with my API key. Why?
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 badge still says Profile fields not ready.
The badge still says Profile fields not ready.
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.
Why don't I see the events list?
Why don't I see the events list?
It only appears after you’ve saved an audience and its profile fields are ready.
Will customers start getting my Mailchimp campaigns?
Will customers start getting my Mailchimp campaigns?
No. New members are added as transactional, not subscribed. They only receive campaigns if they subscribe.
Can I send data to more than one audience?
Can I send data to more than one audience?
No. Yuko sends to the one audience you’ve selected.
Related
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.
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.