MailChimp connector icon

MailChimp Connector

Embed Mailchimp-driven flows inside your SaaS so customers can sync audience contacts, trigger journeys, create or schedule campaigns, and surface campaign analytics — all from your app UI without sending users to Mailchimp.

01

Faster time to market

Ship Mailchimp integrations weeks faster.

02

Multi-tenant reuse

Reuse orchestration across customer accounts.

03

Governed actions

Publish approved Mailchimp methods safely.

04

Embedded experience

Deliver customer-facing workflows natively inside your SaaS product.

CONNECTOR OVERVIEW

Overview

Teams can integrate Mailchimp audiences, campaigns, automations and reporting into their product to synchronize contacts, start Customer Journey steps, create campaigns and pull campaign metrics. Use Cyclr to orchestrate multi-step workflows that create or update audience members, trigger journey steps, schedule campaigns and fetch report data via the Mailchimp Marketing API. See the Mailchimp Marketing API documentation for endpoints and schemas.

PRODUCT USE CASES

Use-case examples

Deliver native features such as one-way or two-way audience syncs, campaign creation and scheduling, automated journey triggers, and scheduled report exports — deployable per customer from your embedded marketplace.

Sync new customer sign-ups into Mailchimp audiences

When users sign up in your app, create or update Mailchimp audience members (contacts) via the Audiences/Contacts endpoints.

Trigger a Mailchimp Customer Journey step

Start an automation step for a contact using the Customer Journeys trigger endpoint to continue user onboarding or lifecycle flows.

Create and schedule campaigns for customers

Create a campaign, set content and schedule sends through Campaigns endpoints, enabling campaign management inside your app.

ORCHESTRATION

How MailChimp works with Cyclr

Cyclr sits between your SaaS product and MailChimp to handle authentication, govern access and orchestrate every API call per customer, at scale.

  1. 1

    Your SaaS product

    Your app requests an action for a specific customer.

  2. 2

    Cyclr orchestration

    Cyclr authenticates, applies policies and routes the request.

  3. 3

    MailChimp

    MailChimp processes the request and returns a response to your app.

Customer-specific authentication · Governed data movement · Centralized visibility and audit

CONNECTOR COVERAGE

Available connector capabilities

Explore MailChimp methods you can orchestrate through Cyclr.

E-Commerce Stores38

List Stores

Action

List all stores.

Create Store

Action

Create a Store.

List Updated Stores

Action

List all stored updated since the last successful run.

Get Store

Action

Get a store.

Delete Store

Action

Delete a store.

Update Store

Action

Update a Store.

List New Stores

Action

List all stores created since the last successful run.

Delete Store Order

Action

Delete an order in a store.

Update Store Customer

Action

Update a customer in a store.

Update Store Order

Action

Update an order in a store.

Delete Store Cart

Action

Deletes a cart in a store.

List Store Product Variants

Action

List all product variants of a product in a store.

Create Store Order

Action

Create an order in a store.

Create Store Product Variant

Action

Create a product variant of a product in a store.

Create Store Customer

Action

Create a customer in a store.

List New Store Product Variants

Action

List all product variants of a product in a store created since the last successful run.

Create Store Cart

Action

Create a cart in a store.

Delete Store Customer

Action

Delete a customer in a store.

Create Store Product

Action

Create a product in a store.

Get Store Product

Action

Get a product in a store.

List Updated Store Product Variants

Action

List all product variants of a product in a store updated since the last successful run.

Get Store Product Variant

Action

Get a product variant of a product in a store.

List Updated Store Customers

Action

List all customers in a store updated since the last successful run.

List Store Carts

Action

List all carts in a store.

Delete Store Product

Action

Delete a product in a store.

List Store Products

Action

List all products in a store.

Get Store Cart

Action

Get a cart in a store.

List Updated Store Carts

Action

List all carts in a store updated since the last successful run.

Get Store Customer

Action

Get a customer in a store.

List New Store Customers

Action

List all customers in a store created since the last successful run.

List Store Customers

Action

List all customers in a store.

Update Store Product Variant

Action

Update a product variant of a product in a store.

Delete Store Product Variant

Action

Delete a product variant of a product in a store.

Get Store Order

Action

Get an order in a store.

Update Store Product

Action

Update a product in a store.

Update Store Cart

Action

Update a cart in a store.

List Store Orders

Action

List all orders in a store.

List New Store Carts

Action

List all carts in a store created since the last successful run.

Campaigns13

Search Campaigns

Action

Search all campaigns.

List Newly Sent Campaigns

Action

List all newly sent campaigns since the last successful run.

List Newly Created And Sent Campaigns

Action

List all campaigns created or sent since the last successful run.

Send Test Email

Action

Send a test email for a campaign.

Delete Campaign

Action

Delete a campaign.

List Campaigns

Action

List all campaigns.

Get Campaign

Action

Get a campaign.

Create Campaign

Action

Create a campaign.

Schedule Campaign

Action

Schedule a campaign for delivery.

Send Campaign

Action

Send a campaign.

List New Campaigns

Action

List all campaigns created since the last successful run.

Update Campaign Settings

Action

Update the settings of a campaign.

Update Campaign Content

Action

Update the content of a campaign.

Lists/Audiences41

List Lists

Action

List all lists.

Create List

Action

Create a list.

Update List

Action

Update a list.

Delete List

Action

Delete a list.

Get List

Action

Get a list.

List New Lists

Action

List all lists created since the last successful run.

Delete List Segment

Action

Delete a segment in a list.

Search List Members

Action

Search all members in a list.

Update List Interest Category

Action

Update an interest category in a list.

Create List Segment

Action

Create a segment in a list.

Get List Interest Category

Action

Get an interest category in a list.

List Updated List Segments

Action

List all segments in a list updated since the last successful run.

List List Merge Fields

Action

List all merge fields in a list.

Update List Segment

Action

Update a segment in a list.

Update List Merge Field

Action

Update a merge field in a list.

Create List Interest Category

Action

Create an interest category in a list.

List New List Segments

Action

List all segments in a list created since the last successful run.

List Subscribe

Webhook

Get a notification of when a contact subscribes to a list.

List List Segments

Action

List all segments in a list.

List List Members

Action

List all members in a list.

Create List Member

Action

Create a member in a list.

Get List Member

Action

Get a member in a list.

Update List Member

Action

Update a member in a list.

Delete List Member

Action

Delete a member from a list.

Get List Segment

Action

Get a segment in a list.

List Unsubscribe

Webhook

Get a notification of when a contact unsubscribes from a list.

Profile Update

Webhook

Get a notification of when a contact profile is updated.

Email Address Change

Webhook

Get a notification of when a contact email address changes.

Cleaned Emails

Webhook

Get a notification of an address that has hard or soft bounced so removed from list of active subscribers.

Campaign Sending Status

Webhook

The status of a campaign.

Upsert List Member

Action

Upsert a member in a list.

Create List Merge Field

Action

Create a merge field in a list.

Delete List Merge Field

Action

Delete a merge field in a list.

Get List Merge Field

Action

Get a merge field in a list.

Create List Interest Category Interest

Action

Create an interest in an interest category in a list.

Delete List Interest Category

Action

Delete an interest category in a list.

Update List Interest Category Interest

Action

Update an interest in an interest category in a list.

Get List Interest Category Interest

Action

Get an interest in an interest category in a list.

List List Interest Categories

Action

List all interest categories in a list.

Delete List Interest Category Interest

Action

Delete an interest in an interest category in a list.

List List Interest Category Interests

Action

List all interests in an interest category in a list.

Reports14

List Campaign Reports

Action

List all campaign reports.

Get Campaign Report

Action

Get a campaign report.

Get Click Details

Action

Get click details for a campaign.

List Unsubscribed Members

Action

List all unsubscribed members for a campaign.

List Campaign Abuse Reports

Action

List all abuse reports for a campaign.

Get Campaign Abuse Report

Action

Get an abuse report for a campaign.

List Click Details

Action

List all click details for a campaign.

List Clicked Link Subscribers

Action

List all members who clicked a specific link in a campaign.

Get Clicked Link Subscriber

Action

Get a member who clicked a specific link in a campaign.

List Campaign Recipients

Action

List all recipients for a campaign.

Get Campaign Recipient

Action

Get the recipient for a campaign.

Get Unsubscribed Member

Action

Get an unsubscribed member for a campaign.

Get Email Activity Report

Action

Get an email activity report for a campaign.

List Email Activity Reports

Action

List all email activity reports for a campaign.

Webhooks2

List Webhooks

Action

List all webhooks.

Delete Webhook

Action

Delete a webhook.

List/Audience8

Create Member

Action

Create a member.

Delete Member

Action

Delete a member.

List Member Activity

Action

List all member activity.

List Members

Action

List all members.

Upsert Member

Action

Upsert a member.

Upsert Member Tags

Action

Upsert tags for a member.

Get Member

Action

Get a member.

Update Member

Action

Update a member.

TECHNICAL DETAILS

MailChimp integration and API details

Review the sourced authentication and API behaviour used when configuring customer-facing MailChimp integrations in Cyclr.

API and authentication

API host
https://.api.mailchimp.com/3.0
Authentication
OAuth 2.0
Credentials

Client ID; Client Secret; Redirect URI (Cyclr Partner Console callback)

Method categories

Audiences/contacts; Campaigns; Automations; Templates; Reports; Batches

View vendor API documentation →

Pagination and rate limits

Pagination

Offset/count pagination (use count and offset; count max 1000). Use the Batch endpoint for very large jobs.

Rate limits

Marketing API enforces ~10 concurrent connections per account; calls may time out at 120 seconds and return 429 on exceed.

IMPLEMENTATION

Authentication at a glance

Cyclr authenticates with Mailchimp using OAuth 2.0. Register a Mailchimp app to obtain a Client ID and Client Secret and set Cyclr’s callback/redirect URI.

Authentication method
OAuth 2.0
Credential required

Client ID; Client Secret; Redirect URI (Cyclr Partner Console callback)

Before you begin:

Register a Mailchimp app and use Cyclr console callback as Redirect URI.

View setup guide

COMMON QUESTIONS

Frequently asked questions

It can sync and manage audience contacts, create and schedule campaigns, trigger Customer Journey steps, run batch updates and retrieve campaign reports via Mailchimp Marketing API endpoints.

OAuth 2.0. Register a Mailchimp app to get a Client ID and Client Secret, and configure your Cyclr Partner Console callback as the redirect URI.

Yes. Cyclr supports multi-tenant deployment patterns so each customer account can authorize Mailchimp separately and use tenant-specific connections.

Yes. Cyclr can publish selected Mailchimp actions and workflows into your embedded marketplace as governed, reusable tools with centralized access and usage controls.