Mailchimp — Connect it to MokonyxSocial

When you publish content, MokonyxSocial can turn it into a Mailchimp email campaign and send it out to one of your audiences (your mailing lists). Think of it as "new post goes out as an email newsletter."

What you need

• A Mailchimp account (free or paid).
• An Audience already set up in Mailchimp — this is the list of people who'll get the email.
• The ability to log in to your Mailchimp account settings (you'll grab one code from there).

Get your credentials

API key — api_key (required)

This is a secret code that lets MokonyxSocial talk to your Mailchimp account on your behalf. It looks like a long jumble of characters ending in something like -us21. That little ending matters — don't trim it off.

1. Sign in at https://admin.mailchimp.com/ .
2. Click your name/profile in the bottom-left corner, then choose Account & billing.
3. Open the Extras menu and click API keys (or go straight to https://admin.mailchimp.com/account/api/ ).
4. Click the Create A Key button.
5. Mailchimp shows you a brand-new key. Copy the whole thing right away and paste it into MokonyxSocial. Tip: give it a name like "MokonyxSocial" so you'll know what it's for later.

Audience ID — list_id (optional)

This tells Mailchimp which of your lists should receive the email. If you only have one audience, you can leave this blank and MokonyxSocial will use your default one.

1. In Mailchimp, click Audience → All contacts.
2. If you have several audiences, choose the one you want from the drop-down near the top.
3. Click Settings, then Audience name and defaults.
4. Look for Audience ID on the right — it's a short code. Copy it and paste it into the list_id box.

Set it up in MokonyxSocial

1. In your Joomla admin, go to Components → MokonyxSocial → Services → New.
2. Choose Mailchimp.
3. Paste in the credentials you just collected.
4. Click Send Test to make sure it connects, then Save & Close and check that the service shows as Published.

Verify

• The Send Test button should give you a green "connected" message.
• Publish a piece of content, then head to Mailchimp → Campaigns. You should see a new campaign for your chosen audience — either sitting as a draft or already sent, depending on how you set the service up.

Troubleshooting

• It says the key is invalid — You probably missed the -us21-style ending when copying. Go back and copy the full key.
• It can't reach Mailchimp — Same cause: that ending tells MokonyxSocial which Mailchimp server you're on. Re-copy the whole key.
• It can't find your list — The Audience ID doesn't match a list on your account. Re-copy it from *Audience name and defaults*, or just leave the box empty to use your default list.
• The email never went out — Make sure your audience actually has confirmed subscribers and that your service is set to send (not just save a draft). Mailchimp won't email an empty list.

Notes & limits

• This sends to a whole list at once — it's a newsletter blast, not a private message.
• Mailchimp has its own rules: you need a verified sending address, a physical mailing address in your footer, and subscribers who've opted in. If those aren't in order, Mailchimp may hold the email.
• Sending very frequently can get temporarily slowed down by Mailchimp.
• If you ever delete the API key in Mailchimp, this connection stops working right away.