Mailchimp is a powerful marketing automation platform that enables you to manage audiences, campaigns, and a wide range of marketing activities all in one place. Mailchimp’s robust API and integrations let you automate outreach, email marketing, reporting, and audience management directly from your workflows in Sim.
With the Mailchimp tools in Sim, you can:
-
Manage Audiences (Lists):
- List and retrieve all your Mailchimp audiences (lists) for easy management.
- Get comprehensive information about a specific audience.
- Create new audiences and keep your segmentation up-to-date.
-
List Members:
- Access and manage list members (subscribers), retrieve member details, and keep your email lists synchronized.
-
Campaign Management:
- Automate campaign creation, send campaigns, and analyze campaign performance with comprehensive reporting.
-
Marketing Automation:
- Manage automated workflows, set up triggers, and schedule emails to streamline your nurture processes.
-
Templates, Segments, and Tags:
- Retrieve and manage your email templates for consistent branding.
- Access and update audience segments to target specific groups.
- Create and manage tags to further organize your contacts.
-
Advanced List Controls:
- Manage merge fields and interest categories (groups) to collect rich, structured data from your subscribers.
- Handle landing pages, signup forms, and other lead-capture tools to maximize conversions.
-
Batch Operations and Reporting:
- Run batch jobs for bulk operations and streamline large updates.
- Retrieve detailed reports on campaigns, automations, and audience growth to inform your marketing strategy.
By using Mailchimp within Sim, your agents and workflows can automate email marketing at scale—growing your audience, personalizing outreach, optimizing engagement, and making data-driven decisions. Whether you’re syncing CRM records, triggering campaigns in response to in-product actions, or managing subscriber data, Mailchimp’s tools in Sim deliver complete programmatic control over your marketing automation.
Integrate Mailchimp into the workflow. Can manage audiences (lists), list members, campaigns, automation workflows, templates, reports, segments, tags, merge fields, interest categories, landing pages, signup forms, and batch operations.
Retrieve a list of audiences (lists) from Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
count | string | No | Number of results (default: 10, max: 1000) |
offset | string | No | Number of results to skip |
| Parameter | Type | Description |
|---|
success | boolean | Whether the audiences were successfully retrieved |
output | object | Audiences data |
↳ lists | json | Array of audience/list objects |
↳ total_items | number | Total number of lists |
↳ total_returned | number | Number of lists returned in this response |
Retrieve details of a specific audience (list) from Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
| Parameter | Type | Description |
|---|
success | boolean | Whether the audience was successfully retrieved |
output | object | Audience data |
↳ list | json | Audience/list object |
↳ list_id | string | The unique ID of the audience |
Create a new audience (list) in Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
audienceName | string | Yes | The name of the list |
contact | string | Yes | JSON object of contact information |
permissionReminder | string | Yes | Permission reminder text |
campaignDefaults | string | Yes | JSON object of default campaign settings |
emailTypeOption | string | Yes | Support multiple email formats |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Created audience data |
↳ list | json | Created audience/list object |
↳ list_id | string | Created audience/list ID |
↳ success | boolean | Operation success |
Update an existing audience (list) in Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
audienceName | string | No | The name of the list |
permissionReminder | string | No | Permission reminder text |
campaignDefaults | string | No | JSON object of default campaign settings |
emailTypeOption | string | No | Support multiple email formats |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Updated audience data |
↳ list | object | Updated audience/list object |
↳ list_id | string | List ID |
↳ success | boolean | Operation success |
Delete an audience (list) from Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list to delete |
| Parameter | Type | Description |
|---|
success | boolean | Whether the audience was successfully deleted |
Retrieve a list of members from a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
status | string | No | Filter by status (subscribed, unsubscribed, cleaned, pending) |
count | string | No | Number of results (default: 10, max: 1000) |
offset | string | No | Number of results to skip |
| Parameter | Type | Description |
|---|
success | boolean | Whether the members were successfully retrieved |
output | object | Members data |
↳ members | json | Array of member objects |
↳ total_items | number | Total number of members |
↳ total_returned | number | Number of members returned in this response |
Retrieve details of a specific member from a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
subscriberEmail | string | Yes | Member email address or MD5 hash |
| Parameter | Type | Description |
|---|
success | boolean | Whether the member was successfully retrieved |
output | object | Member data |
↳ member | json | Member object |
↳ subscriber_hash | string | The MD5 hash of the member email address |
Add a new member to a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
emailAddress | string | Yes | Member email address |
status | string | Yes | Subscriber status |
mergeFields | string | No | JSON object of merge fields |
interests | string | No | JSON object of interests |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Added member data |
↳ member | json | Added member object |
↳ subscriber_hash | string | Subscriber hash ID |
↳ success | boolean | Operation success |
Add a new member or update an existing member in a Mailchimp audience (upsert)
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
subscriberEmail | string | Yes | Member email address or MD5 hash |
emailAddress | string | Yes | Member email address |
statusIfNew | string | Yes | Subscriber status if new member |
mergeFields | string | No | JSON object of merge fields |
interests | string | No | JSON object of interests |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Member data |
↳ member | json | Member object |
↳ subscriber_hash | string | Subscriber hash ID |
↳ success | boolean | Operation success |
Update an existing member in a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
subscriberEmail | string | Yes | Member email address or MD5 hash |
emailAddress | string | No | Member email address |
status | string | No | Subscriber status |
mergeFields | string | No | JSON object of merge fields |
interests | string | No | JSON object of interests |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Updated member data |
↳ member | object | Updated member object |
↳ subscriber_hash | string | Subscriber hash |
↳ success | boolean | Operation success |
Delete a member from a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
subscriberEmail | string | Yes | Member email address or MD5 hash |
| Parameter | Type | Description |
|---|
success | boolean | Whether the member was successfully deleted |
Permanently archive (delete) a member from a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
subscriberEmail | string | Yes | Member email address or MD5 hash |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Archive confirmation |
↳ success | boolean | Operation success |
Restore an archived member to a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
subscriberEmail | string | Yes | Member email address or MD5 hash |
emailAddress | string | Yes | Member email address |
status | string | Yes | Subscriber status |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Unarchived member data |
↳ member | object | Unarchived member object |
↳ subscriber_hash | string | Subscriber hash |
↳ success | boolean | Operation success |
Retrieve a list of campaigns from Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
campaignType | string | No | Filter by campaign type (regular, plaintext, absplit, rss, variate) |
status | string | No | Filter by status (save, paused, schedule, sending, sent) |
count | string | No | Number of results (default: 10, max: 1000) |
offset | string | No | Number of results to skip |
| Parameter | Type | Description |
|---|
success | boolean | Whether the campaigns were successfully retrieved |
output | object | Campaigns data |
↳ campaigns | json | Array of campaign objects |
↳ total_items | number | Total number of campaigns |
↳ total_returned | number | Number of campaigns returned in this response |
Retrieve details of a specific campaign from Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
campaignId | string | Yes | The unique ID for the campaign |
| Parameter | Type | Description |
|---|
success | boolean | Whether the campaign was successfully retrieved |
output | object | Campaign data |
↳ campaign | json | Campaign object |
↳ campaign_id | string | The unique ID of the campaign |
Create a new campaign in Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
campaignType | string | Yes | Campaign type |
campaignSettings | string | Yes | JSON object of campaign settings |
recipients | string | No | JSON object of recipients |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Created campaign data |
↳ campaign | json | Created campaign object |
↳ campaign_id | string | Created campaign ID |
↳ success | boolean | Operation success |
Update an existing campaign in Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
campaignId | string | Yes | The unique ID for the campaign |
campaignSettings | string | No | JSON object of campaign settings |
recipients | string | No | JSON object of recipients |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Updated campaign data |
↳ campaign | object | Updated campaign object |
↳ campaign_id | string | Campaign ID |
↳ success | boolean | Operation success |
Delete a campaign from Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
campaignId | string | Yes | The unique ID for the campaign to delete |
| Parameter | Type | Description |
|---|
success | boolean | Whether the campaign was successfully deleted |
Send a Mailchimp campaign
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
campaignId | string | Yes | The unique ID for the campaign to send |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Send confirmation |
↳ success | boolean | Operation success |
Schedule a Mailchimp campaign to be sent at a specific time
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
campaignId | string | Yes | The unique ID for the campaign to schedule |
scheduleTime | string | Yes | ISO 8601 format date and time |
| Parameter | Type | Description |
|---|
success | boolean | Whether the campaign was successfully scheduled |
Unschedule a previously scheduled Mailchimp campaign
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
campaignId | string | Yes | The unique ID for the campaign to unschedule |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Unschedule confirmation |
↳ success | boolean | Operation success |
Create a copy of an existing Mailchimp campaign
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
campaignId | string | Yes | The unique ID for the campaign to replicate |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Replicated campaign data |
↳ campaign | object | Replicated campaign object |
↳ campaign_id | string | Campaign ID |
↳ success | boolean | Operation success |
Retrieve the HTML and plain-text content for a Mailchimp campaign
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
campaignId | string | Yes | The unique ID for the campaign |
| Parameter | Type | Description |
|---|
success | boolean | Whether the campaign content was successfully retrieved |
output | object | Campaign content data |
↳ content | json | Campaign content object |
Set the content for a Mailchimp campaign
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
campaignId | string | Yes | The unique ID for the campaign |
html | string | No | The HTML content for the campaign |
plainText | string | No | The plain-text content for the campaign |
templateId | string | No | The ID of the template to use |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Campaign content data |
↳ content | object | Campaign content object |
↳ success | boolean | Operation success |
Retrieve a list of automations from Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
count | string | No | Number of results (default: 10, max: 1000) |
offset | string | No | Number of results to skip |
| Parameter | Type | Description |
|---|
success | boolean | Whether the automations were successfully retrieved |
output | object | Automations data |
↳ automations | json | Array of automation objects |
↳ total_items | number | Total number of automations |
↳ total_returned | number | Number of automations returned in this response |
Retrieve details of a specific automation from Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
workflowId | string | Yes | The unique ID for the automation workflow |
| Parameter | Type | Description |
|---|
success | boolean | Whether the automation was successfully retrieved |
output | object | Automation data |
↳ automation | json | Automation object |
↳ workflow_id | string | The unique ID of the automation workflow |
Start all emails in a Mailchimp automation workflow
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
workflowId | string | Yes | The unique ID for the automation workflow |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Start confirmation |
↳ success | boolean | Operation success |
Pause all emails in a Mailchimp automation workflow
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
workflowId | string | Yes | The unique ID for the automation workflow |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Pause confirmation |
↳ success | boolean | Operation success |
Manually add a subscriber to a workflow email queue
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
workflowId | string | Yes | The unique ID for the automation workflow |
workflowEmailId | string | Yes | The unique ID for the workflow email |
emailAddress | string | Yes | Email address of the subscriber |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Subscriber queue data |
↳ subscriber | json | Subscriber object |
↳ success | boolean | Operation success |
Retrieve a list of templates from Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
count | string | No | Number of results (default: 10, max: 1000) |
offset | string | No | Number of results to skip |
| Parameter | Type | Description |
|---|
success | boolean | Whether the templates were successfully retrieved |
output | object | Templates data |
↳ templates | json | Array of template objects |
↳ total_items | number | Total number of templates |
↳ total_returned | number | Number of templates returned in this response |
Retrieve details of a specific template from Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
templateId | string | Yes | The unique ID for the template |
| Parameter | Type | Description |
|---|
success | boolean | Whether the template was successfully retrieved |
output | object | Template data |
↳ template | json | Template object |
↳ template_id | string | The unique ID of the template |
Create a new template in Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
templateName | string | Yes | The name of the template |
templateHtml | string | Yes | The HTML content for the template |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Created template data |
↳ template | json | Created template object |
↳ template_id | string | Created template ID |
↳ success | boolean | Operation success |
Update an existing template in Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
templateId | string | Yes | The unique ID for the template |
templateName | string | No | The name of the template |
templateHtml | string | No | The HTML content for the template |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Updated template data |
↳ template | object | Updated template object |
↳ template_id | string | Template ID |
↳ success | boolean | Operation success |
Delete a template from Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
templateId | string | Yes | The unique ID for the template to delete |
| Parameter | Type | Description |
|---|
success | boolean | Whether the template was successfully deleted |
Retrieve a list of campaign reports from Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
count | string | No | Number of results (default: 10, max: 1000) |
offset | string | No | Number of results to skip |
| Parameter | Type | Description |
|---|
success | boolean | Whether the campaign reports were successfully retrieved |
output | object | Campaign reports data |
↳ reports | json | Array of campaign report objects |
↳ total_items | number | Total number of reports |
↳ total_returned | number | Number of reports returned in this response |
Retrieve the report for a specific campaign from Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
campaignId | string | Yes | The unique ID for the campaign |
| Parameter | Type | Description |
|---|
success | boolean | Whether the campaign report was successfully retrieved |
output | object | Campaign report data |
↳ report | json | Campaign report object |
↳ campaign_id | string | The unique ID of the campaign |
Retrieve a list of segments from a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
count | string | No | Number of results (default: 10, max: 1000) |
offset | string | No | Number of results to skip |
| Parameter | Type | Description |
|---|
success | boolean | Whether the segments were successfully retrieved |
output | object | Segments data |
↳ segments | json | Array of segment objects |
↳ total_items | number | Total number of segments |
↳ total_returned | number | Number of segments returned in this response |
Retrieve details of a specific segment from a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
segmentId | string | Yes | The unique ID for the segment |
| Parameter | Type | Description |
|---|
success | boolean | Whether the segment was successfully retrieved |
output | object | Segment data |
↳ segment | json | Segment object |
↳ segment_id | string | The unique ID of the segment |
Create a new segment in a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
segmentName | string | Yes | The name of the segment |
segmentOptions | string | No | JSON object of segment options |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Created segment data |
↳ segment | json | Created segment object |
↳ segment_id | string | Created segment ID |
↳ success | boolean | Operation success |
Update an existing segment in a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
segmentId | string | Yes | The unique ID for the segment |
segmentName | string | No | The name of the segment |
segmentOptions | string | No | JSON object of segment options |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Updated segment data |
↳ segment | object | Updated segment object |
↳ segment_id | string | Segment ID |
↳ success | boolean | Operation success |
Delete a segment from a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
segmentId | string | Yes | The unique ID for the segment to delete |
| Parameter | Type | Description |
|---|
success | boolean | Whether the segment was successfully deleted |
Retrieve members of a specific segment from a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
segmentId | string | Yes | The unique ID for the segment |
count | string | No | Number of results (default: 10, max: 1000) |
offset | string | No | Number of results to skip |
| Parameter | Type | Description |
|---|
success | boolean | Whether the segment members were successfully retrieved |
output | object | Segment members data |
↳ members | json | Array of member objects |
↳ total_items | number | Total number of members |
↳ total_returned | number | Number of members returned in this response |
Add a member to a specific segment in a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
segmentId | string | Yes | The unique ID for the segment |
emailAddress | string | Yes | Email address of the member |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Added member data |
↳ member | json | Added member object |
↳ success | boolean | Operation success |
Remove a member from a specific segment in a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
segmentId | string | Yes | The unique ID for the segment |
subscriberEmail | string | Yes | Member email address or MD5 hash |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Removal confirmation |
↳ success | boolean | Operation success |
Retrieve tags associated with a member in a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
subscriberEmail | string | Yes | Member email address or MD5 hash |
| Parameter | Type | Description |
|---|
success | boolean | Whether the member tags were successfully retrieved |
output | object | Member tags data |
↳ tags | json | Array of tag objects |
↳ total_items | number | Total number of tags |
↳ total_returned | number | Number of tags returned in this response |
Add tags to a member in a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
subscriberEmail | string | Yes | Member email address or MD5 hash |
tags | string | Yes | JSON array of tags |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Tag addition confirmation |
↳ success | boolean | Operation success |
Remove tags from a member in a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
subscriberEmail | string | Yes | Member email address or MD5 hash |
tags | string | Yes | JSON array of tags with inactive status |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Tag removal confirmation |
↳ success | boolean | Operation success |
Retrieve a list of merge fields from a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
count | string | No | Number of results (default: 10, max: 1000) |
offset | string | No | Number of results to skip |
| Parameter | Type | Description |
|---|
success | boolean | Whether the merge fields were successfully retrieved |
output | object | Merge fields data |
↳ mergeFields | json | Array of merge field objects |
↳ total_items | number | Total number of merge fields |
↳ total_returned | number | Number of merge fields returned in this response |
Retrieve details of a specific merge field from a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
mergeId | string | Yes | The unique ID for the merge field |
| Parameter | Type | Description |
|---|
success | boolean | Whether the merge field was successfully retrieved |
output | object | Merge field data |
↳ mergeField | json | Merge field object |
↳ merge_id | string | The unique ID of the merge field |
Create a new merge field in a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
mergeName | string | Yes | The name of the merge field |
mergeType | string | Yes | The type of the merge field (text, number, address, phone, date, url, imageurl, radio, dropdown, birthday, zip) |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Created merge field data |
↳ mergeField | json | Created merge field object |
↳ merge_id | string | Created merge field ID |
↳ success | boolean | Operation success |
Update an existing merge field in a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
mergeId | string | Yes | The unique ID for the merge field |
mergeName | string | No | The name of the merge field |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Updated merge field data |
↳ mergeField | object | Updated merge field object |
↳ merge_id | string | Merge field ID |
↳ success | boolean | Operation success |
Delete a merge field from a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
mergeId | string | Yes | The unique ID for the merge field to delete |
| Parameter | Type | Description |
|---|
success | boolean | Whether the merge field was successfully deleted |
Retrieve a list of interest categories from a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
count | string | No | Number of results (default: 10, max: 1000) |
offset | string | No | Number of results to skip |
| Parameter | Type | Description |
|---|
success | boolean | Whether the interest categories were successfully retrieved |
output | object | Interest categories data |
↳ categories | json | Array of interest category objects |
↳ total_items | number | Total number of categories |
↳ total_returned | number | Number of categories returned in this response |
Retrieve details of a specific interest category from a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
interestCategoryId | string | Yes | The unique ID for the interest category |
| Parameter | Type | Description |
|---|
success | boolean | Whether the interest category was successfully retrieved |
output | object | Interest category data |
↳ category | json | Interest category object |
↳ interest_category_id | string | The unique ID of the interest category |
Create a new interest category in a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
interestCategoryTitle | string | Yes | The title of the interest category |
interestCategoryType | string | Yes | The type of interest category (checkboxes, dropdown, radio, hidden) |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Created interest category data |
↳ category | json | Created interest category object |
↳ interest_category_id | string | Created interest category ID |
↳ success | boolean | Operation success |
Update an existing interest category in a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
interestCategoryId | string | Yes | The unique ID for the interest category |
interestCategoryTitle | string | No | The title of the interest category |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Updated interest category data |
↳ category | object | Updated interest category object |
↳ interest_category_id | string | Interest category ID |
↳ success | boolean | Operation success |
Delete an interest category from a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
interestCategoryId | string | Yes | The unique ID for the interest category to delete |
| Parameter | Type | Description |
|---|
success | boolean | Whether the interest category was successfully deleted |
Retrieve a list of interests from an interest category in a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
interestCategoryId | string | Yes | The unique ID for the interest category |
count | string | No | Number of results (default: 10, max: 1000) |
offset | string | No | Number of results to skip |
| Parameter | Type | Description |
|---|
success | boolean | Whether the interests were successfully retrieved |
output | object | Interests data |
↳ interests | json | Array of interest objects |
↳ total_items | number | Total number of interests |
↳ total_returned | number | Number of interests returned in this response |
Retrieve details of a specific interest from an interest category in a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
interestCategoryId | string | Yes | The unique ID for the interest category |
interestId | string | Yes | The unique ID for the interest |
| Parameter | Type | Description |
|---|
success | boolean | Whether the interest was successfully retrieved |
output | object | Interest data |
↳ interest | json | Interest object |
↳ interest_id | string | The unique ID of the interest |
Create a new interest in an interest category in a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
interestCategoryId | string | Yes | The unique ID for the interest category |
interestName | string | Yes | The name of the interest |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Created interest data |
↳ interest | json | Created interest object |
↳ interest_id | string | Created interest ID |
↳ success | boolean | Operation success |
Update an existing interest in an interest category in a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
interestCategoryId | string | Yes | The unique ID for the interest category |
interestId | string | Yes | The unique ID for the interest |
interestName | string | No | The name of the interest |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Updated interest data |
↳ interest | object | Updated interest object |
↳ interest_id | string | Interest ID |
↳ success | boolean | Operation success |
Delete an interest from an interest category in a Mailchimp audience
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
listId | string | Yes | The unique ID for the list |
interestCategoryId | string | Yes | The unique ID for the interest category |
interestId | string | Yes | The unique ID for the interest to delete |
| Parameter | Type | Description |
|---|
success | boolean | Whether the interest was successfully deleted |
Retrieve a list of landing pages from Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
count | string | No | Number of results (default: 10, max: 1000) |
offset | string | No | Number of results to skip |
| Parameter | Type | Description |
|---|
success | boolean | Whether the landing pages were successfully retrieved |
output | object | Landing pages data |
↳ landingPages | json | Array of landing page objects |
↳ total_items | number | Total number of landing pages |
↳ total_returned | number | Number of landing pages returned in this response |
Retrieve details of a specific landing page from Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
pageId | string | Yes | The unique ID for the landing page |
| Parameter | Type | Description |
|---|
success | boolean | Whether the landing page was successfully retrieved |
output | object | Landing page data |
↳ landingPage | json | Landing page object |
↳ page_id | string | The unique ID of the landing page |
Create a new landing page in Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
landingPageType | string | Yes | The type of landing page (signup) |
landingPageTitle | string | No | The title of the landing page |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Created landing page data |
↳ landingPage | json | Created landing page object |
↳ page_id | string | Created landing page ID |
↳ success | boolean | Operation success |
Update an existing landing page in Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
pageId | string | Yes | The unique ID for the landing page |
landingPageTitle | string | No | The title of the landing page |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Updated landing page data |
↳ landingPage | object | Updated landing page object |
↳ page_id | string | Landing page ID |
↳ success | boolean | Operation success |
Delete a landing page from Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
pageId | string | Yes | The unique ID for the landing page to delete |
| Parameter | Type | Description |
|---|
success | boolean | Whether the landing page was successfully deleted |
Publish a landing page in Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
pageId | string | Yes | The unique ID for the landing page |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Publish confirmation |
↳ success | boolean | Operation success |
Unpublish a landing page in Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
pageId | string | Yes | The unique ID for the landing page |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Unpublish confirmation |
↳ success | boolean | Operation success |
Retrieve a list of batch operations from Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
count | string | No | Number of results (default: 10, max: 1000) |
offset | string | No | Number of results to skip |
| Parameter | Type | Description |
|---|
success | boolean | Whether the batch operations were successfully retrieved |
output | object | Batch operations data |
↳ batches | json | Array of batch operation objects |
↳ total_items | number | Total number of batch operations |
↳ total_returned | number | Number of batch operations returned in this response |
Retrieve details of a specific batch operation from Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
batchId | string | Yes | The unique ID for the batch operation |
| Parameter | Type | Description |
|---|
success | boolean | Whether the batch operation was successfully retrieved |
output | object | Batch operation data |
↳ batch | json | Batch operation object |
↳ batch_id | string | The unique ID of the batch operation |
Create a new batch operation in Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
operations | string | Yes | JSON array of operations |
| Parameter | Type | Description |
|---|
success | boolean | Operation success status |
output | object | Created batch operation data |
↳ batch | json | Created batch operation object |
↳ batch_id | string | Created batch operation ID |
↳ success | boolean | Operation success |
Delete a batch operation from Mailchimp
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Mailchimp API key with server prefix |
batchId | string | Yes | The unique ID for the batch operation to delete |
| Parameter | Type | Description |
|---|
success | boolean | Whether the batch operation was successfully deleted |