Mailchimp Integration
'Connect Mailchimp to Supervity, manage audiences, subscribers, trigger campaigns, and track reports in operators and workflows.'
This guide explains how to connect Mailchimp to Supervity, what data is available after connection, how operators can use Mailchimp data and actions within workflows, and how to remove the integration when needed.
Overview
The Supervity Mailchimp integration allows your workspace to securely connect Mailchimp as a governed platform capability.
Once connected, operators and workflows can use Mailchimp data and actions to organize marketing audiences, automate subscriber management, structure custom tags, deploy campaigns, and retrieve detailed analytics.
With the Mailchimp integration, Supervity can:
- Manage marketing audiences
- Control subscriber lists
- Categorize members
- Review analytics
- Manage layout templates
- Structure list segments
- Retrieve audience tags
All Mailchimp access is governed through Supervity's security, permissions, and audit controls.
Prerequisites
Before connecting Mailchimp, ensure you have:
- An active Supervity workspace
- An active Mailchimp account
- Permission to authorize third-party applications on your Mailchimp account
Depending on your account configuration, some administrative operations may require Owner permissions in Mailchimp.
Adding the Mailchimp Integration
Follow these steps to connect Mailchimp to Supervity. If you encounter any issues during setup, refer to the Troubleshooting section of this guide.
Step 1: Open Integrations
- Log in to Supervity.
- From the left navigation bar, click the Integrations icon.
This opens the Integrations page, where all available integrations are listed. Connected integrations and available integrations can both be managed from this page.
Step 2: Select Mailchimp
- Locate Mailchimp in the available integrations list.
- Click Connect.
Step 3: Authorize Access
You will be redirected to Mailchimp's secure authorization page.
Enter your Mailchimp login credentials, review the requested permissions, and click Allow (or Authorize) to grant Supervity access to your Mailchimp account.
Supervity uses Mailchimp's standard OAuth 2.0 authorization flow. Your Mailchimp credentials are never shared with or stored by Supervity.
Step 4: Complete Connection
After authorization, you will be redirected back to Supervity. The Mailchimp integration will appear as Connected on the Integrations page. Your workspace can now securely access Mailchimp capabilities according to the permissions granted.
Having trouble? See the Troubleshooting section for step-by-step help with common setup issues.
How Mailchimp Works in Supervity
After connection, Mailchimp becomes available as a governed platform tool.
Operators can use Mailchimp capabilities when planning and executing tasks, while workflows can automate actions using Mailchimp data.
Common use cases include:
- Automatically adding new leads captured from contact web forms to your newsletter audience
- Applying purchase-specific tags to customer profiles inside Mailchimp
- Deploying or scheduling marketing newsletter campaigns dynamically
- Pulling campaign report statistics to populate marketing analytics boards
- Syncing segments and templates across databases
Using Mailchimp in Operators
Connected Mailchimp capabilities become available to operators automatically. Operators determine when Mailchimp data or actions are required to complete a task and execute accordingly, while remaining governed by workspace permissions, security controls, and approval policies.
What Operators Can Do with Mailchimp
Operators can perform the following actions using Mailchimp:
- List audiences and retrieve specific audience details
- List subscribers, get details, add new contacts, update info, or delete subscribers
- Manage tags by adding or removing member tags
- List campaign lists, create campaigns, edit parameters, delete drafts, send emails, or schedule runs
- Fetch email performance metrics (such as opens, clicks, and bounces) from campaign reports
- List layout templates
- List segments and create custom segments for list filters
- Get current audience tags
Typical Operator Use Cases
| Use Case | Example |
|---|---|
| Subscriber Ingestion | Add new leads to a specific newsletter audience after form completions |
| Audience Tagging | Apply or remove tags from customer profiles based on action events |
| Newsletter Deployment | Create draft campaigns, set templates, and send or schedule newsletters |
| Campaign Review | Retrieve performance logs (click rates) from sent campaigns to generate reports |
| Target Segmentation | Create a custom audience segment for target marketing lists |
Features & Prerequisites
For each Mailchimp capability available in Supervity, the following describes the use case and the prerequisites required before use.
Audience & Subscriber Operations
Use Case: Get audiences, get specific audience details, get subscriber lists, retrieve details of a specific subscriber, add new subscribers, update subscriber details, or remove subscribers.
Prerequisites:
- Mailchimp account connected to Supervity
- Existing audience lists in Mailchimp
Member Tag Operations
Use Case: Apply or remove custom tags on specific audience members to categorize contacts.
Prerequisites:
- Mailchimp account connected to Supervity
Campaign Operations
Use Case: List campaigns, retrieve campaign details, create draft campaigns, update campaign content, delete draft campaigns, send campaigns immediately, or schedule campaigns for future send times.
Prerequisites:
- Mailchimp account connected to Supervity
- Verified sending domain configured in Mailchimp
Campaign Reports
Use Case: Get detailed performance metrics, open rates, and click metrics for sent campaigns.
Prerequisites:
- Mailchimp account connected to Supervity
Template Operations
Use Case: Get configured email templates to design campaign layouts.
Prerequisites:
- Mailchimp account connected to Supervity
Segment Operations
Use Case: Get audience segments or create new segments to target specific subgroups.
Prerequisites:
- Mailchimp account connected to Supervity
Tag Operations
Use Case: Get configured tags for an audience list.
Prerequisites:
- Mailchimp account connected to Supervity
Permissions Requested
Supervity only requests the permissions required for enabled Mailchimp capabilities.
Depending on the features used in your workspace, permissions may include:
| Permission Type | Purpose |
|---|---|
| Lists/Audiences | Read and write contact lists, subscribers, custom fields, and tags |
| Campaigns | Create, edit, send, and schedule marketing campaigns |
| Reports | Access campaign activity and statistics |
| Templates | Read configured layout templates |
| Offline Access | Maintain integration connectivity without requiring constant re-authentication |
Supervity follows least-privilege principles and only accesses data necessary to provide requested functionality.
Authentication & Security
The Mailchimp integration uses OAuth 2.0 authentication.
Security controls include:
- Encrypted credential storage (AES-256)
- Scoped access policies
- Token refresh and rotation support
- Immediate revocation capabilities
- Workspace-level governance controls
- Complete audit logging
- TLS 1.3 for all connection pipelines
All Mailchimp access remains subject to Supervity security policies and role-based permissions.
Managing the Integration
View Connection Status
From the left navigation bar, click the Integrations icon.
For Mailchimp you can view:
- Connection status
- Connected account name
- Last usage information
- Associated workflows and operators
Reconnect Mailchimp
If Mailchimp authorization expires: Open the Integrations page from the left navigation bar. Select Mailchimp. Click Reconnect. Complete authorization again through the Mailchimp portal.
Existing workflows and operators do not need to be recreated.
Removing the Mailchimp Integration
You can remove the Mailchimp connection from your Supervity workspace at any time directly from within the Supervity platform.
Steps to Remove
Log in to Supervity. From the left navigation bar, click the Integrations icon. Locate and select Mailchimp from the integrations list. Click Disconnect. Confirm the action when prompted.
Implications of Removal
Once removed:
- Supervity immediately loses all access to your Mailchimp account and lists
- No new Mailchimp data will be read or processed after removal
- All active Mailchimp connections within your Supervity workspace are terminated
- Scheduled or active workflows that depend on Mailchimp will stop executing
- Mailchimp-dependent workflow steps will fail safely with clear error messages
- Existing workflow definitions within Supervity are not deleted — only the active connection is terminated
- Historical execution logs remain available for auditing purposes
Disconnecting Mailchimp does not delete workflow definitions, operators, or previously generated outputs.
How Your Data Is Handled After Removal
Data Handling on Removal:
- Supervity immediately loses access to your Mailchimp account upon removal
- No new Mailchimp audiences, campaigns, or report data will be collected or processed after disconnection
- Temporary files processed during workflow execution are deleted after execution completes
- Mailchimp access tokens and all account-related data are permanently deleted from Supervity's platform within 15 minutes of disconnection — no background access continues after removal
Auditing & Observability
All Mailchimp activity performed through Supervity is logged.
Audit records include:
- Which operator requested access
- Which workflow executed the action
- Timestamp of execution
- Success or failure status
- Relevant inputs and outputs (sensitive values are redacted)
This supports compliance, troubleshooting, governance, and operational visibility.
Troubleshooting
If you encounter issues at any stage, refer to the steps below. For issues not covered here, contact the Supervity support team.
Authorization Failed During Setup
Likely Cause: Incorrect Mailchimp account credentials, or corporate tenant policies restricting third-party applications.
Resolution:
- Ensure you are signed in to the correct Mailchimp account.
- Return to Supervity → Integrations → Mailchimp and click Connect to retry.
- If the issue persists, contact your IT administrator.
Audience Not Found (Mismatched IDs)
Likely Cause: The target Audience List has been deleted in Mailchimp, or the list ID input in the workflow is incorrect.
Resolution:
- Log in to Mailchimp and open the Audience dashboard.
- Confirm the audience exists and copy its unique List ID from settings.
- Update the List ID parameter in your workflow execution step.
Connection Expired or Token Invalid
Likely Cause: Security policies may force token expiration or revocation.
Resolution:
- Go to Integrations → Mailchimp → Reconnect.
- Complete the Mailchimp authorization flow again.
- Existing workflows do not need to be reconfigured after reconnection.
Workflow Cannot Access Mailchimp
Likely Cause: Mailchimp may have been disconnected, or workspace governance policies may restrict access.
Resolution:
- Confirm Mailchimp is still connected under the Integrations page.
- Verify the workflow has permission to use Mailchimp within your workspace governance settings.
- Check that workspace policies allow Mailchimp execution for the relevant operators or workflows.
Frequently Asked Questions
Q: Can I connect multiple Mailchimp accounts to Supervity?
Yes. Each connected account is authenticated independently. You can configure and connect multiple Mailchimp accounts in your workspace settings.
Q: Does Supervity store my Mailchimp password?
No. Authentication is handled completely via standard OAuth 2.0. Supervity only receives and stores securely encrypted access tokens.
Q: Will I need to reconfigure my workflows after reconnecting Mailchimp?
No. If you reconnect Mailchimp due to token expiry, existing workflows and operators will continue working without reconfiguration.
Q: What happens to my workflows if I disconnect or remove Mailchimp?
Workflow definitions are not deleted when Mailchimp is disconnected or removed. However, any workflow steps that depend on Mailchimp will fail safely with clear error messages until Mailchimp is reconnected.
Q: How do I authorize the Supervity Mailchimp integration?
Log in to Supervity at Supervity, navigate to the Integrations page from the left navigation bar, locate Mailchimp, and click Connect. You will be redirected to Mailchimp's authorization page where you can review and approve the requested permissions. After authorization, you will be redirected back to Supervity automatically. See the Adding the Mailchimp Integration section above for full step-by-step instructions.
Q: Who do I contact if I have an issue with the integration?
Contact the Supervity support team. See the Support section below for full contact details, support hours, and SLA information.
Support
If you need assistance with the Mailchimp integration, visit the Support page.
Support Hours
- Monday to Friday, 9:00 AM – 6:00 PM IST
- Requests submitted outside business hours will be addressed on the next business day
First Response SLA
- All support requests receive an initial response within 24 business hours
Contact Information
| Contact Type | Details |
|---|---|
| Support | Support & Contact |
| Sales Inquiries | sales@supervity.ai |
| Contact Form | https://www.supervity.ai/contact-us |
| Website | https://www.supervity.ai |
| Privacy Policy | https://supervity.ai/privacy-policy |
| Terms of Service | https://www.supervity.ai/terms-of-service |
| Acceptable Use Policy | https://supervity.ai/acceptable-use-policy |
When Contacting Support, Please Provide
- Workspace name
- Connected account name
- Relevant workflow or operator information
- Error messages or screenshots when available
This helps the support team investigate and resolve issues more quickly.