Skip to main content

Mailchimp Integration - Setup Guide

Connect your Mailchimp account to Goodweek to manage audiences, campaigns, segments, and email marketing data directly from your AI workspace.

A
Written by Antoine Stempien

Connect your Mailchimp account to Goodweek to manage audiences, campaigns, segments, and email marketing data directly from your AI workspace.

ℹ️ Governance note

Goodweek will never exceed the access levels granted to the user within Mailchimp, guaranteeing alignment with your organization's governance policies. Outcomes and available features may vary depending on each user's specific permissions and authenticated access.

📋 Prerequisites

Before any user can see and connect the Mailchimp integration, your organization admin must first enable it from the Goodweek Admin Panel under the Integrations tab.

Admin Setup

The Mailchimp integration uses OAuth 2.0 and does not require any admin-level approval within Mailchimp before users can connect.

User Connection

  1. In Goodweek, go to Integrations.

  2. Find Mailchimp and click Connect.

  3. You will be redirected to Mailchimp, where you will be asked to sign in and authorize access.

  4. Click Allow to grant access and return to Goodweek.

Important Notes

  • Each user must connect their own account individually.

  • Goodweek can only access the Mailchimp account and data that your individual user credentials have access to.

  • You can revoke Goodweek's access at any time from Mailchimp → Account → Extras → Registered Apps → Composio → Revoke access.


Available Tools

Tool

Description

Type

Get Lists Info

Retrieves information about all audiences (lists) in the Mailchimp account.

Read

Get List Info

Retrieves detailed information about a specific audience including subscriber counts and settings.

Read

Add List

Creates a new audience (list) in the Mailchimp account.

Write

Get Members Info

Retrieves information about members (subscribers) in a specific Mailchimp audience with filtering and pagination.

Read

Get Member Info

Retrieves detailed information about a specific list member including subscription status and merge fields.

Read

Add or Update List Member

Adds or updates a list member (subscriber) in a Mailchimp audience — creates if new, updates if existing.

Write

Add Contact to Audience

Creates a new omni-channel contact in a Mailchimp audience.

Write

Batch Subscribe or Unsubscribe

Batch subscribes or unsubscribes list members in a single request.

Read

Archive List Member

Archives a list member from an audience, removing them from active counts.

Write

Add Member Note

Adds an internal note to a specific subscriber in a Mailchimp audience.

Write

Get List Segments

Retrieves information about all segments for a specific Mailchimp audience.

Read

Get Segment Info

Retrieves details about a specific segment in a Mailchimp audience.

Read

Add Segment

Creates a new static or dynamic segment in a Mailchimp audience.

Write

Add Member to Segment

Adds an existing subscriber to a static segment (tag) in Mailchimp.

Write

List Members in Segment

Lists information about members in a saved segment.

Read

List Campaigns

Lists all campaigns in the Mailchimp account with pagination and filtering.

Read

Get Campaign Info

Retrieves information and settings for a specific campaign.

Read

Add Campaign

Creates a new Mailchimp campaign.

Write

Get Campaign Report

Retrieves detailed performance analytics for a sent campaign including opens, clicks, and bounces.

Read

List Campaign Reports

Retrieves analytics reports for multiple sent campaigns.

Read

Get Campaign Content

Retrieves the HTML and plain-text content for a campaign.

Read

List Campaign Folders

Lists all folders used to organize campaigns in Mailchimp.

Read

Add Campaign Folder

Creates a new campaign folder to organize email campaigns.

Write

Get Landing Page Info

Retrieves details about a specific Mailchimp landing page including status, tracking, and URLs.

Read

Get Landing Page Report

Retrieves analytics data for a specific landing page including visits, clicks, and subscriptions.

Read

List Landing Pages

Lists all landing pages in the Mailchimp account.

Read

Add Landing Page

Creates a new unpublished landing page in Mailchimp.

Write

Get Template Info

Retrieves information about a specific email template.

Read

Add Template

Creates a new email template in the Mailchimp account.

Write

Get Growth History by Month

Retrieves detailed subscriber growth statistics for an audience for a specific month.

Read

List Growth History Data

Retrieves a month-by-month summary of an audience's growth activity.

Read

Get Member Tag

Lists all tags applied to a specific list member.

Read

Get API Root and Account Info

Retrieves Mailchimp account details and links to all available API resources.

Read

Add or Remove Member Tags

Adds or removes tags from a list member to organize and segment your audience.

⚠️ Destructive

Delete Campaign

Permanently deletes a campaign from the Mailchimp account. This action is irreversible.

⚠️ Destructive

Delete List Member

Permanently deletes a list member and all their PII. This action is irreversible.

⚠️ Destructive

Delete Segment

Permanently deletes a segment from a Mailchimp audience.

⚠️ Destructive

Delete Template

Permanently deletes a user-created email template from the Mailchimp account.

⚠️ Destructive

Use Cases

  • Review audience and campaign performance. Retrieve campaign analytics, open rates, click rates, and audience growth statistics from Goodweek without opening the Mailchimp dashboard.

  • Manage subscribers and segments. Add or update list members, apply or remove tags, and create audience segments from Goodweek to keep your contact lists organized and up to date.

  • Create and organize campaigns. Create new email campaigns and organize them into folders directly from Goodweek as part of planning your marketing calendar.

  • Access landing page data. Retrieve landing page performance reports from Goodweek to review the effectiveness of specific acquisition flows alongside other campaign data.


Troubleshooting

Connected but only some audiences are visible

Goodweek can access all audiences associated with the connected Mailchimp account. If audiences are missing, verify you connected with the correct Mailchimp account.

Integration not visible in Goodweek

Make sure your organization admin has enabled the Mailchimp integration from the Goodweek Admin Panel under the Integrations tab.

References

Did this answer your question?