BusyBot

Reference · Credentials

Mailchimp API credentials

Used by 2 BusyBot nodes.

Type mailchimpApi 1 field

The Mailchimp credential holds an API key from your Mailchimp account. The trailing part of the key — the `-us1`, `-us19` style suffix — identifies your datacenter and is part of the key, so never trim it when pasting.

Fields

FieldTypeRequiredNotes
API Key
apiKey		 password Yes Your Mailchimp API key. Format: {key}-{datacenter}.

Getting your credentials

  1. Sign in to Mailchimp.
  2. Open your account settings and find the Extras → API keys area.
  3. Create a new API key and copy the whole value, including everything after the hyphen.
  4. Paste it into the credential’s API Key field in BusyBot.

Permissions and scopes

A Mailchimp API key carries the access of the user that created it across that account. There are no per-key scopes, so treat it as a full-access secret and rotate it if it may have been exposed.

Troubleshooting

  • 401 or ‘Your API key may be invalid’ — the key was truncated, most often by dropping the datacenter suffix after the hyphen.
  • Member exists — Mailchimp rejects re-subscribing an address that already exists in the audience. Treat it as an expected outcome and branch on it.
  • Compliance state errors — an address that unsubscribed or was flagged cannot be re-added through the API. That is Mailchimp policy, not a credential problem.

Frequently asked questions

What is the `-us1` part of my key?

The datacenter your Mailchimp account lives in. It is part of the key and part of the API hostname, so trimming it breaks authentication.

Can I restrict what the key can do?

Mailchimp API keys are not individually scoped, so they carry the creating user's full access. Rotate the key if it may have been exposed.

Why can I not re-subscribe an unsubscribed contact?

Mailchimp blocks that by policy — the person has to opt back in themselves. It is not an authentication problem.

Nodes that use Mailchimp API

One credential works across every node below — create it once and reuse it.

Last updated . Spotted something wrong? Tell us.