Skip to main content

Mailchimp

Prefer guided AI setup?

Instead of following these steps manually, you can use the AI Credential Assistant — describe what you want to connect and the AI will walk you through the setup step by step, tailored to your account.

Overview​

Connect your Mailchimp account to Nirvai to manage email campaigns, audiences, and marketing automation workflows.

Supported Authentication Methods​

  • API Key - Standard Mailchimp API key

Prerequisites​

  • A Mailchimp account (free or paid)
  • Admin or Manager role in your Mailchimp account

Setup Instructions​

Generating an API Key​

  1. Log in to your Mailchimp account
  2. Click your profile icon (bottom-left)
  3. Go to Account & billing
  4. Navigate to Extras > API keys
  5. In the "Your API keys" section, click Create A Key
  6. Give your key a descriptive label (e.g., "Nirvai Integration")
  7. Click Generate Key
  8. Copy the API key immediately (format: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-us1)
  9. In Nirvai, create a new Mailchimp credential and paste the key

Understanding the API Key Format​

Mailchimp API keys have two parts:

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-us1
|_______________________________|  |__|
        API Key                  Data Center

The suffix (e.g., us1, us2, eu1) indicates your data center. This is automatically extracted from the key for API calls.

API Key Permissions​

API keys have full access to your Mailchimp account. For limited access:

  • Consider using OAuth2 for user-facing applications
  • Create separate keys for different integrations
  • Regularly audit and revoke unused keys

Troubleshooting​

Common Issues​

  • 401 Unauthorized: API key is invalid or was revoked. Generate a new key.
  • 403 Forbidden: Account may be paused or have billing issues.
  • Wrong data center: Ensure you're using the correct API endpoint for your key's data center.
  • Rate limits: Mailchimp has rate limits; implement exponential backoff for retries.

Finding Your Data Center​

Your data center is in the API key suffix. You can also find it:

  1. Log into Mailchimp
  2. Look at the URL: https://us1.admin.mailchimp.com (us1 is your data center)

API Rate Limits​

  • Maximum 10 simultaneous connections
  • No hard request limit, but excessive requests may be throttled
  • Use batch endpoints for bulk operations

Adapted for Nirvai platform

Next Steps​

Got your credential? Connect it to an agent

Use the AI Tool Creator to turn this credential into agent-callable tools. Describe what your agent should be able to do and the AI investigates the API, configures the endpoints, and gives you a reviewable toolkit before saving anything.