Skip to content
Cobalz Affiliate

Mailchimp integration

Push approved affiliates into a Mailchimp audience for onboarding sequences, monthly newsletters, and tier-based segments. Mailchimp's tag + merge-field system is what you'll use to segment.

Setup

  • In Mailchimp: Profile → Account & billing → Extras → API keys → Create A Key. Save it.
  • Mailchimp API keys look like abc1234-us12 — the suffix after the dash is your data center.
  • Create or pick an audience. Copy its list_id from Audience → Settings → Audience name and defaults.
  • In Cobalz: Settings → Integrations → Mailchimp. Paste API key + list id, save.

What syncs

  • On affiliate.approved: we PUT the member with status: subscribed, merge fields FNAME, LNAME, and tags cobalz-approved, tier:<name>.
  • On affiliate.suspended: we add the cobalz-suspended tag. We do not unsubscribe automatically.
  • Backfill: Settings → Integrations → Mailchimp → Sync existing affiliates.

Merge fields we set

  • FNAME — first name (split from display_name).
  • LNAME — last name.
  • COBSLUG — affiliate slug.
  • COBTIER — tier name.

Tags we apply

  • cobalz-approved — anyone we've pushed in.
  • cobalz-suspended — anyone we've subsequently suspended.
  • tier:<name> — your tier name (lowercased). Re-applies on tier promotion.
Note:Mailchimp uses MD5(email) as the member id. Email-case changes don't create duplicates, but if the affiliate changes their email entirely, the old Mailchimp member stays and a new one is created — you'll need to clean that up manually.