skills/sales-mailchimp/SKILL.md
Mailchimp platform help — email marketing campaigns, Customer Journey Builder automations, SMS marketing, audience management/CRM, landing pages, A/B testing, multivariate testing, transactional email (Mandrill), Content Studio, generative AI (Intuit Assist), retargeting ads, 300+ integrations. Use when Mailchimp campaigns have low open rates, Customer Journey Builder automations not firing, audience lists messy or duplicate-heavy, Mandrill transactional emails bouncing, or Mailchimp emails landing in spam. Do NOT use for general email marketing strategy (use /sales-email-marketing), cross-platform email deliverability (use /sales-deliverability), funnel strategy (use /sales-funnel), or connecting tools via middleware (use /sales-integration).
npx skillsauth add sales-skills/sales sales-mailchimpInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Help the user with Mailchimp platform questions — from email campaign setup and Customer Journey Builder automations through SMS marketing, audience management, landing pages, A/B testing, transactional email (Mandrill), Content Studio, retargeting ads, and integrations.
If references/learnings.md exists, read it first for accumulated knowledge.
Ask the user:
What area of Mailchimp do you need help with?
What's your role?
What are you trying to accomplish? (describe your specific goal or question)
If the user's request already provides most of this context, skip directly to the relevant step. Lead with your best-effort answer using reasonable assumptions (stated explicitly), then ask only the most critical 1-2 clarifying questions at the end — don't gate your response behind gathering complete context.
Note: If the user needs a specialized skill, route them there with a brief explanation of why that skill is a better fit.
If the request maps to a specialized skill, route:
/sales-email-marketing/sales-deliverability/sales-funnel/sales-integration/sales-checkoutOtherwise, answer directly from platform knowledge using the reference below.
Read references/platform-guide.md for detailed module documentation, pricing, integrations, and data model.
You no longer need the platform guide details — focus on the user's specific situation.
Based on the user's specific question:
Setting up an email campaign:
*|FNAME|*)Building a Customer Journey automation (Standard+ required):
Setting up SMS marketing:
Creating a landing page with form:
Connecting to Shopify/WooCommerce:
Best-effort from research — verify details against current Mailchimp documentation.
references/learnings.md with today's date./sales-email-marketing — Email marketing strategy and best practices (platform-agnostic)/sales-deliverability — Cross-platform email deliverability — SPF/DKIM/DMARC, warmup, inbox placement/sales-funnel — Funnel strategy and conversion optimization/sales-integration — Connect Mailchimp to other tools via Zapier, Make, or API/sales-checkout — Checkout and payment page optimization (pairs with Mailchimp e-commerce integrations)/sales-do — Not sure which skill to use? The router matches any sales objective to the right skill. Install: npx skills add sales-skills/sales --skill sales-doUser says: "How do I set up a welcome email series for new customers from my Shopify store in Mailchimp?" Skill does:
User says: "I'm moving from Klaviyo to Mailchimp. What do I need to know?" Skill does:
User says: "I want to set up abandoned cart recovery with both email and SMS in Mailchimp." Skill does:
Symptom: Recipients report finding Mailchimp emails in spam, or open rates are unusually low across campaigns
Cause: Missing or misconfigured domain authentication (SPF/DKIM/DMARC), sending to unengaged contacts, spammy content, or sudden volume spikes after migration
Solution: Verify domain authentication in Settings > Domains — Mailchimp provides guided setup for SPF, DKIM, and DMARC. Remove contacts who haven't engaged in 6+ months to improve sender reputation. Check campaign content for spam trigger words. If you recently migrated, send to your most engaged segment first and gradually expand volume over 2-4 weeks. Use Mailchimp's inbox preview tool to check rendering and spam score. See /sales-deliverability for a comprehensive diagnosis framework.
Symptom: Customers or subscribers are not entering a Customer Journey or not receiving automated emails Cause: Journey is paused or in draft, trigger conditions are too narrow, contacts don't match the entry criteria, or the contact is in a status that prevents sending (unsubscribed, cleaned, pending) Solution: Verify the journey status is "Active" (not draft or paused). Check the trigger conditions — ensure they match the contacts you expect to enter. Verify contacts have "subscribed" status (Mailchimp will not send marketing email to unsubscribed, cleaned, or pending contacts). Check if the contact has already been through the journey (some journeys only allow one entry per contact). Test with a known contact by manually triggering the entry action (e.g., adding a tag). Review the journey activity log for errors or skipped contacts.
Symptom: Automation scenarios (Make, Zapier, or direct API) fail to find or update contacts because of status filter mismatches — e.g., filtering for "transactional" when the contact is "non-subscribed", or vice versa
Cause: Mailchimp has 5 distinct contact statuses that are easily conflated: subscribed (opted in, receives marketing), unsubscribed (opted out), non-subscribed (in audience but never opted in — e.g., imported or transactional-only), cleaned (hard-bounced, permanently removed from sending), and transactional (can only receive Mandrill transactional emails, excluded from marketing). The API treats these as separate enum values. Automation tools like Make expose them as filter options, and selecting the wrong one silently returns zero results.
Solution: Before building automations, verify the exact status of target contacts in Mailchimp's audience view (filter by status). In Make's "Watch Subscribers" module, set the status filter to match the actual contact status — not what you think it should be. Use "any" status if unsure, then filter downstream. For bulk archiving non-subscribed contacts, use the Marketing API PATCH /lists/{list_id}/members/{subscriber_hash} with "status": "unsubscribed" first, then archive via DELETE — you cannot archive a contact directly from all statuses. Test with "Run once" and disconnect downstream actions to avoid accidental data loss.
Symptom: Unsubscribe rates spike significantly after migrating to Mailchimp from another ESP Cause: Importing contacts who were not recently engaged, contacts not recognizing the new sender, or Mailchimp's different footer/branding confusing recipients Solution: Only import contacts who have engaged (opened or clicked) in the last 90-180 days. Send a re-introduction email explaining the platform change before resuming regular campaigns. Customize the email footer to match your brand so it looks familiar. Segment by engagement level and start with your most active contacts. If you imported unsubscribed contacts by mistake, archive them immediately — remember Mailchimp bills for all contacts regardless of status. Monitor unsubscribe rates per campaign and pause sending to cold segments if rates exceed 0.5%.
tools
UpViral platform help — viral referral marketing and list-building platform (by Emarky) for viral sweepstakes, giveaway/reward campaigns, pre-launch waiting lists, and milestone referral programs, with REST API (app.upviral.com/api/v1/), callback-URL webhooks, PHP SDK, fraud detection (IP-based suspicious-referral flagging), A/B testing, smart leaderboards, unlockable incentives, and 30+ native ESP/CRM integrations (Mailchimp, ActiveCampaign, ConvertKit, AWeber, HubSpot, Klaviyo, Intercom) plus Zapier/Make/Pipedream/Integrately/Pabbly. Use when UpViral campaigns aren't tracking referral points correctly, deciding between Starter $79/mo annual (10K leads, 1 brand, NO API) vs Business $119/mo (25K, 2 brands, API + webhooks unlocked) vs Premium $319/mo (100K, 5 brands, dedicated account manager), the API returns errors because you're on the Starter tier where API/webhooks are gated, building an UpViral→CRM or UpViral→data-warehouse pipeline with add_contact / get_leads / get_leads_points / add_points / get_custom_fields / lists methods (uvapikey + uvmethod form-encoded POST), interpreting fraud flags where same-IP referrals get marked suspicious and you must manually activate/delete/blacklist, setting up the Callback URL (webhook) to fire on reward-unlock events, Zapier New Lead / New Reward Unlocked triggers not firing, ClickFunnels/Shopify/funnel-builder integration breaking, the drag-and-drop page builder showing broken widgets or limited customization, the setup feeling long and complicated for your first campaign, or picking UpViral over Viral Loops / KickoffLabs / Vyper / Prefinery / Gleam / KingSumo / ShortStack for a viral campaign. Do NOT use for general newsletter audience growth strategy across all platforms (use /sales-audience-growth), newsletter monetization (use /sales-newsletter), KickoffLabs-specific help (use /sales-kickofflabs), no-code merge-tag newsletter referrals (use /sales-referralkit), SparkLoop paid recommendations (use /sales-sparkloop), or full-stack multi-level Level-1/2/3 referral/affiliate tracking (use /sales-referralhero).
development
ReferralHero platform help — full-stack referral, affiliate, waitlist, contest, and NPS platform with subscriber API, webhooks, Zapier, Mailchimp/Kit/AWeber/Klaviyo/ActiveCampaign/SendLane connectors, coupon codes, multi-level referral tracking (Level 1/2/3), anti-fraud, and 5,000 calls/hour rate limit. Use when ReferralHero campaigns aren't tracking referrals correctly, deciding between PRO $199/mo (10K members, includes API + webhooks) and PREMIUM $399/mo (50K members, adds ReCaptcha + SMS verification), authentication is failing with no_token or X-API-Key header is being ignored, multi-level referral counts (Level 2/3) aren't appearing for downline subscribers, coupon group endpoints return 404 or coupon arrays max out, hitting the 5,000 calls/hour soft limit and getting too_many_calls 429s, the Mailchimp/Kit native integration is double-adding subscribers, webhook payloads aren't firing on confirmation events, importing Stripe customer IDs through transaction tracking, generating reward fulfillment when subscribers cross milestone thresholds (promote/unlock_promoted_reward), comparing ReferralHero against SparkLoop/ReferralKit/Viral Loops/GrowSurf/KickoffLabs for referral marketing, or routing referral data via add_bulk_transactions (500-transaction batch limit). Do NOT use for general newsletter audience growth strategy (use /sales-audience-growth), general newsletter monetization (use /sales-newsletter), no-code newsletter-only referral with merge-tag insertion (use /sales-referralkit), SparkLoop's paid recommendations or partner network (use /sales-sparkloop), or affiliate program strategy across many platforms (use /sales-affiliate-program).
tools
KickoffLabs platform help — viral marketing platform for pre-launch waitlists, bonus-entry giveaways, milestone-reward referral programs, leaderboard giveaways, and email opt-in bribes with REST API v1 + v2, server-side webhooks (in/out), KOL.js JavaScript library, AnyForm script for custom pages, fraud detection (duplicate_ip / bounced / duplidate_email flags), SMS verification add-on, native ESP integrations (Klaviyo, Mailchimp, ActiveCampaign, Brevo), website builders (Webflow, Wix, Squarespace, Weebly), Shopify, Facebook Audiences, Slack, Zapier. Use when KickoffLabs viral campaigns aren't tracking referrals correctly, deciding between Hobby $13/mo annual (500 leads/mo no A/B no reward emails) vs Premium $48/mo (2.5K + A/B + reward emails + tracking pixels) vs Business $99/mo (10K + custom email templates + custom domains + advanced reporting + 3 team) vs Enterprise $202/mo (25K + 5 team + SMS included), API key getting rejected because you embedded it in client-side JavaScript instead of server-side, can't decide whether to use v1 /subscribe vs v2 /tags/:TAG_ID/lead for lead creation, webhook payloads firing with `__fraudulent` flag and you need to interpret the duplicate_ip/bounced/duplidate_email reason codes (yes, duplidate is spelled that way in their docs), AnyForm script not posting to KickoffLabs vs native API endpoint, leaderboard endpoint returning more than 50 leads is not allowed, social_id (kid in share URLs) attribution chain breaking between v1 and v2, contest score vs lead count metrics in the webhook payload are confusing, SMS Verification only available on Premium+ as $50/mo add-on (Enterprise includes), per-month lead cap auto-upgrades at $8 per 1000 overage leads, picking between KickoffLabs and Viral Loops / UpViral / Prefinery / ReferralCandy / Voucherify for viral campaign type fit, or rate limit per tier (10-100 calls/minute) is hitting on bulk imports. Do NOT use for general newsletter audience growth strategy (use /sales-audience-growth), general newsletter monetization (use /sales-newsletter), no-code merge-tag-only newsletter referrals (use /sales-referralkit), SparkLoop paid recommendations + partner network (use /sales-sparkloop), or full-stack referral/affiliate with multi-level Level-1/2/3 tracking (use /sales-referralhero).
development
Routes any sales, marketing, ad, or GTM objective to the right specialized skill and outputs the install command for that skill plus a ready-to-paste prompt packed with the user's context. Asks clarifying questions when the objective is ambiguous, then hands back a copy-paste-runnable next step. Covers prospecting, outbound cadences, deals, proposals, forecasting, deliverability, enrichment, intent, content, coaching, CRO, SEO, launch directories, newsletters, email/SMS/push marketing, chatbots, influencer marketing, social media, employee advocacy, media relations, reviews, data hygiene, B2B advertising, retargeting, affiliate, loyalty, digital products, memberships, webinars, checkout, and platform-specific help. Use when the user has a sales or marketing question and isn't sure which skill to use, or wants a multi-skill sequence with a batch install command. Do NOT use to solve problems directly — this skill only routes.