Skip to main content
Mailchimp logo
  • Category: email newsletters
  • Auth: OAUTH2
  • Composio-managed OAuth available? Yes
  • Tools: 277
  • Triggers: 4
  • Slug: MAILCHIMP
  • Version: 20261101_00

Frequently Asked Questions

If Mailchimp tools fail despite the connection looking correct, check the user’s Mailchimp plan. Some Mailchimp API/tool capabilities require at least the Mailchimp Essentials plan. A free Mailchimp account may not be enough for the requested tool flow.

Tools

Slug: MAILCHIMP_ADD_AUTOMATIONCreate a new classic abandoned cart automation in your Mailchimp account. This action creates an automation workflow that sends emails to customers who have abandoned their shopping cart. Requires a connected e-commerce store and an audience/list. Prerequisites: - A Mailchimp audience/list (use MAILCHIMP_ADD_LIST or MAILCHIMP_GET_LISTS_INFO) - A connected e-commerce store (use MAILCHIMP_ADD_STORE or MAILCHIMP_LIST_STORES) Note: Classic automations are only available to paid Mailchimp accounts that have previously created a classic automation. Currently only the ‘abandonedCart’ workflow type is supported via the API.

Input Parameters

string
The email address that recipients can reply to (e.g., ‘support@yourcompany.com’).
string
required
The unique ID of the Mailchimp audience/list that this automation will target. Required for creating an automation. Get this from MAILCHIMP_GET_LISTS_INFO.
string
The sender name that appears in the “From” field of automation emails (e.g., ‘Your Company Name’). Not an email address.
string
The unique ID of the connected e-commerce store. Required for abandonedCart workflow type to enable cart tracking. Get this from MAILCHIMP_LIST_STORES.
string
The type of classic automation workflow to create. Currently only ‘abandonedCart’ is supported via the API. This triggers emails when a customer abandons their shopping cart.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_BATCH_WEBHOOKConfigure a webhook that will fire whenever any batch request completes processing. You may only have a maximum of 20 batch webhooks.

Input Parameters

string
required
A valid URL for the batch webhook. Mailchimp will POST data to this URL when a batch operation completes processing. Must be a publicly accessible HTTPS URL.
boolean
Whether the webhook should be enabled to receive requests. Defaults to True if not specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_CAMPAIGNCreate a new Mailchimp campaign.

Input Parameters

string ("regular" | "plaintext" | "absplit" | "rss" | "variate")
required
There are four types of campaigns you can create in Mailchimp. A/B Split campaigns have been deprecated and variate campaigns should be used instead.
string ("template" | "multichannel")
How the campaign”s content is put together. The old drag and drop editor uses “template” while the new editor uses “multichannel”. Defaults to template.
string
The title of the campaign.
boolean
Whether to track opens. Defaults to true. Cannot be set to false for variate campaigns.
string
The campaign”s custom “To” name. Typically the first name audience field.
boolean
Whether to enable e-commerce tracking.
string
The reply-to email address for the campaign. Note: while this field is not required for campaign creation, it is required for sending.
string
The title for the card. Typically the subject line of the campaign.
string
The custom slug for ClickTale tracking (max of 50 bytes).
string
The unique list id.
string
The URL for the RSS feed.
string ("daily" | "weekly" | "monthly")
The frequency of the RSS Campaign.
string
If the campaign is listed in a folder, the id for that folder.
string
The “from” name on the campaign (not an email address).
boolean
Automatically tweet a link to the campaign archive page when the campaign is sent.
boolean
Automatically inline the CSS included with the campaign content.
boolean
Whether Mailchimp authenticated the campaign. Defaults to true.
Automatically append Mailchimp”s default footer to the campaign.
boolean
Allows Facebook comments on the campaign (also force-enables the Campaign Archive toolbar). Defaults to true.
integer
The id of the template to use.
boolean
Whether to track clicks in the HTML version of the campaign. Defaults to true. Cannot be set to false for variate campaigns.
boolean
Whether to track clicks in the plain-text version of the campaign. Defaults to true. Cannot be set to false for variate campaigns.
string
The preview text for the campaign.
string
The subject line for the campaign.
array
An array of Facebook page ids to auto-post to.
string
The url for the header image for the card.
boolean
Update contact notes for a campaign based on subscriber email addresses.
boolean
Deprecated
integer
The hour to send the campaign in local time. Acceptable hours are 0-23. For example, “4” would be 4am in your account”s default time zone.
string
A short summary of the campaign to display.
boolean
Use Mailchimp Conversation feature to manage out-of-office replies.
string
The custom slug for Google Analytics tracking (max of 50 bytes).
boolean
Update contact notes for a campaign based on subscriber email addresses.
integer
The percentage of recipients to send the test combinations to, must be a value between 10 and 100.
integer
The number of minutes to wait before choosing the winning campaign. The value of wait_time must be greater than 0 and in whole hours, specified in minutes.
boolean
Whether to add CSS to images in the RSS feed to constrain their width in campaigns.
boolean
Create a campaign in a connected Salesforce account.
array
The possible from names. The number of from_names provided must match the number of reply_to_addresses. If no from_names are provided, settings.from_name will be used.
array
The possible send times to test. The times provided should be in the format YYYY-MM-DD HH:MM:SS. If send_times are provided to test, the test_size will be set to 100% and winner_criteria will be ignored.
string ("any" | "all")
Segment match type.
array
The possible subject lines to test. If no subject lines are provided, settings.subject_line will be used.
string ("opens" | "clicks" | "manual" | "total_revenue")
The combination that performs the best. This may be determined automatically by click rate, open rate, or total revenue — or you may choose manually based on the reporting data you find the most valuable. For Multivariate Campaigns testing send_time, winner_criteria is ignored. For Multivariate Campaigns with “manual” as the winner_criteria, the winner must be chosen in the Mailchimp web application.
array
Segment match conditions. There are multiple possible types, see the condition types documentation.
string ("sunday" | "monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday")
The day of the week to send a weekly RSS Campaign.
array
The possible reply-to addresses. The number of reply_to_addresses provided must match the number of from_names. If no reply_to_addresses are provided, settings.reply_to will be used.
boolean
Sends the daily RSS Campaign on Fridays.
boolean
Sends the daily RSS Campaign on Mondays.
boolean
Sends the daily RSS Campaign on Sundays.
integer
The day of the month to send a monthly RSS Campaign. Acceptable days are 0-31, where “0” is always the last day of a month. Months with fewer than the selected number of days will not have an RSS campaign sent out that day. For example, RSS Campaigns set to send on the 30th will not go out in February.
boolean
Sends the daily RSS Campaign on Tuesdays.
boolean
Sends the daily RSS Campaign on Saturdays.
boolean
Sends the daily RSS Campaign on Thursdays.
boolean
Sends the daily RSS Campaign on Wednesdays.
integer
The id for an existing saved segment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_CAMPAIGN_FEEDBACKAdd feedback on a specific Mailchimp campaign. Use this to post comments, notes, or feedback while collaborating on a campaign with your team. The feedback can be associated with a specific content block or applied to the campaign as a whole.

Input Parameters

string
required
The content of the feedback message. This is the text of the feedback comment.
integer
The block ID for the editable block that the feedback addresses. Optional - omit if providing general feedback on the campaign.
string
required
The unique ID for the campaign. You can get this from the List Campaigns endpoint or when creating a campaign.
boolean
Whether the feedback item is complete. Set to true to mark as resolved, false otherwise. Defaults to false if not provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_CAMPAIGN_FOLDERCreate a new campaign folder to organize email campaigns in Mailchimp. Campaign folders help organize your email marketing campaigns into logical groups. Returns the created folder’s ID, name, and initial campaign count (0).

Input Parameters

string
required
The name for the new campaign folder. This is used to organize campaigns in the Mailchimp interface.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_CARTAdd a new cart to a store.

Input Parameters

string
required
A unique identifier for the cart.
array
required
An array of the cart’s line items. Each line item must include: ‘id’ (unique identifier for the line item), ‘product_id’ (ID of the product in your store), ‘product_variant_id’ (ID of the product variant), ‘quantity’ (number of items), and ‘price’ (price of the item as a number). Example: [{‘id’: ‘line1’, ‘product_id’: ‘prod123’, ‘product_variant_id’: ‘var123’, ‘quantity’: 1, ‘price’: 29.99}]
string
required
The unique identifier for the e-commerce store. Must be an existing store ID in your Mailchimp account.
number
The total tax amount for the cart. Optional field that can be used to track tax separately.
string
A string that uniquely identifies the campaign for a cart.
number
required
The total price for all items in the cart. This should be the sum of all line item prices multiplied by their quantities.
string
The URL for the cart. This parameter is required for Abandoned Cart automations.
string
required
A unique identifier for the customer who owns this cart. Limited to 50 characters. Required field.
string
required
The three-letter ISO 4217 currency code (e.g., ‘USD’, ‘EUR’, ‘GBP’). Must match the currency configured for the store.
string
The customer’s company name.
string
The customer’s last name.
string
The customer’s first name.
string
The city the customer is located in.
string
required
Required. The customer’s email address. Must be a valid, real email address.
boolean
required
Required. The customer’s opt-in status. This value will never overwrite the opt-in status of a pre-existing Mailchimp list member, but will apply to list members that are added through the e-commerce API endpoints. Customers who don’t opt in to your Mailchimp list will be added as Transactional members.
string
The customer’s country.
string
The mailing address of the customer.
string
An additional field for the customer’s mailing address.
string
The customer’s state name or normalized province.
string
The customer’s postal or zip code.
string
The two-letter ISO country code for the customer’s country (e.g., ‘US’, ‘DE’).
string
The two-letter code for the customer’s province or state.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_CART_LINE_ITEMAdd a new line item to an existing cart.

Input Parameters

string
required
A unique identifier for the cart line item. Must be unique within the cart.
number
required
The price per unit for the cart line item in the store’s currency.
string
required
The unique identifier for the cart to add the line item to.
integer
required
The quantity of this product variant to add to the cart. Must be a positive integer.
string
required
The unique identifier for the e-commerce store.
string
required
The unique identifier for the product. The product must already exist in the store.
string
required
The unique identifier for the product variant. The variant must exist for the specified product.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_CONNECTED_SITECreate a new Mailchimp connected site. Connected sites allow you to track website visitor activity and integrate with Mailchimp’s marketing features. After adding a connected site, you’ll receive a tracking script (site_script) that should be installed on your website to enable visitor tracking.

Input Parameters

string
required
The full domain name of the connected site (e.g., ‘example.com’ or ‘shop.mystore.com’). This is the website URL where the Mailchimp tracking script will be installed.
string
required
A unique identifier for the connected site that you define. This ID is used to reference the site in subsequent API calls. Example: ‘my-website-001’ or ‘store-12345’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_CONTACT_TO_AUDIENCETool to create a new omni-channel contact in a Mailchimp audience. Use when adding contacts with email and/or SMS channels to an audience.

Input Parameters

array
An array of tag names to add to the contact. This operation is append-only; existing tags will be preserved, and only new tags from this array will be added.
string
The subscriber’s language preference as a two-letter ISO 639-1 code (e.g., ‘en’, ‘es’, ‘fr’).
string ("historical" | "live")
Data processing mode.
string
required
The unique ID for the audience. Get this from the Mailchimp account or via the list audiences endpoint.
object
SMS channel details for a contact.
object
A dictionary of merge fields where the keys are the merge tags (like FNAME, LNAME). Values are strings representing the field values. See the Merge Fields documentation for more about the structure.
object
Email channel details for a contact.
string ("ignore_required_checks" | "strict")
Merge field validation mode.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_DOMAIN_TO_ACCOUNTAdd a sending domain to the Mailchimp account for email verification. This action adds a new domain to your Mailchimp account and initiates the verification process by sending a verification code to the specified email address. After calling this action, use the ‘verify_domain’ action with the received verification code to complete the domain verification process.

Input Parameters

string
required
The email address at the domain you want to verify (e.g., ‘admin@yourdomain.com’). A verification code will be sent to this email address to confirm domain ownership. You must have access to this email inbox to complete the verification process.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_EVENTAdd an event for a list member. Use this action to track contact activity and behavior outside of email campaigns. Events can be used for segmentation and triggering automation workflows. Common use cases: - Track purchases, signups, or page visits - Record custom milestones or achievements - Import historical events with is_syncing=true to avoid triggering automations Note: Returns 204 No Content on success (empty response body).

Input Parameters

string
required
The name for this type of event (e.g., ‘purchased’, ‘visited’, ‘signup_completed’). Must be 2-30 characters in length. Use lowercase letters, numbers, and underscores only.
string
required
The unique ID for the Mailchimp list/audience.
boolean
Set to true to prevent this event from triggering automations. Useful when bulk-importing historical events.
object
Optional key-value pairs of custom properties for the event. Example: {‘product_name’: ‘T-Shirt’, ‘price’: ‘29.99’}. Property names must be 2-30 characters.
string
The date and time the event occurred in ISO 8601 format (e.g., ‘2024-01-15T10:30:00Z’). Defaults to current time if not specified.
string
required
The MD5 hash of the lowercase version of the list member’s email address. This endpoint also accepts a list member’s email address or contact_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_EXPORTCreate a new account export in your Mailchimp account. This action initiates an export of your Mailchimp account data as a downloadable ZIP file. The export runs in the background and may take from a few minutes to several hours depending on account size. Use the ‘get_account_export_info’ action with the returned export_id to check progress and retrieve the download URL. Important limitations: - Only one export can run at a time per account - Only one export can be created per 24-hour period - Completed exports are available for download for 90 days

Input Parameters

array
required
The types of data to include in the export. At least one stage is required. Available stages: ‘audiences’ (contact lists and segments), ‘campaigns’ (email campaign content), ‘events’ (contact activity events), ‘gallery_files’ (uploaded images and files), ‘reports’ (campaign performance reports), ‘templates’ (email template designs). Example: [‘audiences’, ‘campaigns’] to export both audiences and campaigns.
string
Optional ISO 8601 timestamp to limit the export to data created after this time. Format: YYYY-MM-DDTHH:MM:SS+00:00 (e.g., ‘2024-01-15T00:00:00+00:00’). Note: This limit does NOT apply to audiences - all audience data is always included. Useful for incremental exports when you only need recent campaign reports or events.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_FILEUpload a new image or file to the Mailchimp File Manager. Use this action to upload files (images, documents, etc.) that can be used in campaigns, templates, or signup forms. The file must be base64-encoded and under 10MB. Supported image types: jpg, jpeg, gif, png, svg. Supported document types: pdf, txt, csv, and more. The uploaded file will be available at the returned full_size_url for use in your content.

Input Parameters

string
required
The name of the file including extension (e.g., ‘image.png’, ‘document.pdf’). This will be the display name in the File Manager.
string
required
The base64-encoded contents of the file to upload. The file must be a supported type (images: jpg, jpeg, gif, png, svg; documents: pdf, txt, csv, etc.) and under 10MB.
integer
The ID of the folder to upload the file to. If not provided, the file will be uploaded to the root folder.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_FOLDERCreate a new folder in the File Manager to organize uploaded files. Use this action to create organizational folders in the Mailchimp File Manager. Folders help organize images and other files that can be used in campaigns and templates.

Input Parameters

string
required
The name of the folder to create in the File Manager. Must be unique within the account.
string
The date and time the folder was created in ISO 8601 format.
string
The username of the profile that created the folder.
integer
The number of files in the folder.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_INTEREST_CATEGORYCreate a new interest category.

Input Parameters

string ("checkboxes" | "dropdown" | "radio" | "hidden")
required
Determines how this category’s interests appear on signup forms. Options: ‘checkboxes’ (multiple selection), ‘dropdown’ (single selection from dropdown), ‘radio’ (single selection from radio buttons), ‘hidden’ (not visible on forms).
string
required
The text description of this category. This field appears on signup forms and is often phrased as a question (e.g., ‘What topics interest you?’).
string
required
The unique ID for the list/audience to add the interest category to.
integer
The order that the categories are displayed in the list. Lower numbers display first. Defaults to 0 if not specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_INTEREST_IN_CATEGORYCreate a new interest or ‘group name’ for a specific category.

Input Parameters

string
required
The name of the interest (group name). This is shown publicly on subscription forms and used to group subscribers by their preferences.
string
required
The unique ID for the Mailchimp list/audience (e.g., ‘abc123def4’).
integer
The display order for this interest within the category. Lower numbers display first. If not specified, the interest is added at the end.
string
required
The unique ID for the interest category (group) where the interest will be added (e.g., ‘xyz789ghi0’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_LANDING_PAGECreate a new Mailchimp landing page. Creates an unpublished landing page that can be customized and published later. Requires either a list_id or use_default_list=true. The landing page type can be ‘signup’ (for email list signups) or ‘product’ (for product promotions, requires store_id).

Input Parameters

string
The internal name of this landing page (for your reference, not visible to visitors).
string ("signup" | "product")
The type of landing page template: ‘signup’ for email list signups, or ‘product’ for product promotions.
string
The title of this landing page displayed in the browser’s title bar.
string
The audience/list ID to associate with this landing page. Either list_id or use_default_list=true must be provided.
string
The ID of the e-commerce store to associate with this landing page. Required for ‘product’ type pages.
string
A brief description of this landing page for internal reference.
integer
The specific template ID to use for this landing page. If not provided, a default template is used.
boolean
If true, creates the landing page using the account’s default list instead of requiring a list_id. Either list_id or use_default_list=true must be provided.
boolean
Enable Mailchimp cookie tracking to monitor unique visitors and calculate conversion rates.
boolean
Enable Google’s restricted data processing for CCPA compliance, limiting how Google uses certain identifiers and data in its services.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_LISTCreate a new audience (list) in your Mailchimp account. This endpoint creates a new audience/list for managing email contacts. Each audience has unique settings for campaigns, permissions, and contact information. Note: Free Mailchimp accounts are limited to 1 audience. Paid plans allow multiple audiences. Required fields include: name, contact information (company, address1, city, country), permission_reminder, and campaign defaults (from_name, from_email, subject, language).

Input Parameters

string
required
The name of the audience/list. Must be unique within your Mailchimp account.
string
The postal or zip code for the list contact (optional).
boolean
Whether to require double opt-in (subscriber must confirm via email). Recommended for GDPR compliance. Defaults to false.
string
required
The city for the list contact. Required.
string
The phone number for the list contact. Optional.
string
The state or province for the list contact (optional).
boolean
Whether campaigns for this list use the Archive Bar in archives by default. Defaults to false.
string
required
The company name for the list. Required.
string
required
A two-character ISO3166 country code (e.g., ‘US’, ‘GB’, ‘CA’). Required.
string
required
The street address for the list contact. Required.
string
The secondary street address for the list contact (optional).
boolean
Whether subscribers can choose their email format (HTML vs plain-text). When true, subscribers choose their format. When false, all receive HTML with plain-text backup.
string
Email address to send subscribe notifications to. Provide a valid email address or omit to disable notifications.
string
required
The permission reminder explaining why contacts are receiving emails from this list. Example: ‘You are receiving this email because you opted in via our website.’
boolean
Whether to enable GDPR-friendly marketing permissions. Defaults to false.
string
Email address to send unsubscribe notifications to. Provide a valid email address or omit to disable notifications.
string
required
The default subject line for campaigns sent to this list. Required.
string
required
The default language for this list’s forms (e.g., ‘en’ for English). Required.
string
required
The default ‘From’ name for campaigns sent to this list. Required.
string
required
The default ‘From’ email address for campaigns sent to this list. Required.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_LIST_MEMBERCreate a new member in a Mailchimp audience without updating duplicates.

Input Parameters

boolean
Whether the subscriber has VIP status.
array
Tag names to apply to the new member.
string
IP address used to confirm the subscriber’s opt-in status.
string ("subscribed" | "unsubscribed" | "cleaned" | "pending" | "transactional")
required
Subscriber status: ‘subscribed’, ‘unsubscribed’, ‘cleaned’, ‘pending’, or ‘transactional’.
string
required
The unique ID for the list.
string
Subscriber language preference as a two-letter ISO 639-1 code.
object
Subscriber latitude and longitude.
object
Interest IDs mapped to whether the member opted in to each interest.
string
IP address the subscriber signed up from.
string ("html" | "text")
Type of email the member requested: ‘html’ or ‘text’.
object
Merge-field values keyed by the audience’s merge tags.
string
required
Email address for the subscriber.
string
When the subscriber confirmed opt-in, in ISO 8601 format.
string
When the subscriber signed up, in ISO 8601 format.
array
Marketing permission choices for the subscriber.
boolean
If true, accept member data without values for merge fields that are normally required. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_MEMBER_NOTEAdd a new note for a specific subscriber in a Mailchimp list (audience). Notes are useful for keeping internal records about contacts, such as conversation history, preferences, or other relevant information.

Input Parameters

string
required
The content of the note to add to the member. Note length is limited to 1,000 characters.
string
required
The unique ID for the list (audience).
string
required
The MD5 hash of the lowercase version of the list member’s email address. Alternatively, you can provide the member’s email address or contact_id directly.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_MEMBER_TO_SEGMENTAdd an existing list member to a static segment (tag) in Mailchimp. This action adds a subscriber who is already a member of the specified list to a static segment. Static segments are also referred to as tags in Mailchimp’s UI. Important notes: - The subscriber must already exist in the list before they can be added to a segment. - This only works with static segments, not saved segments that use conditions. - To add a member to a list first, use the Add Member To List action.

Input Parameters

string
required
The unique ID for the Mailchimp audience/list. This can be found in the Audience settings or retrieved using the Get Lists Info action.
string
required
The unique ID of the static segment (also known as a tag) within the list. This must be a static segment, not a saved segment with conditions. The segment ID can be retrieved using the List Segments action.
string
required
The email address of the subscriber to add to the segment. The subscriber must already exist in the list; this action does not create new list members.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_MERGE_FIELDAdd a new merge field for a specific audience.

Input Parameters

string
The merge tag used in campaigns (e.g., ‘FNAME’, ‘COMPANY’). Must be 1-10 uppercase letters/numbers. If not provided, Mailchimp auto-generates one from the name.
string
required
The display name of the merge field shown to users (e.g., ‘First Name’, ‘Company’).
string ("text" | "number" | "address" | "phone" | "date" | "url" | "imageurl" | "radio" | "dropdown" | "birthday" | "zip")
required
The field type. Use ‘text’ for general text, ‘number’ for numeric values, ‘address’ for full addresses, ‘phone’ for phone numbers, ‘date’ for dates, ‘url’ for web links, ‘imageurl’ for image URLs, ‘radio’ or ‘dropdown’ for single-choice fields (requires options_choices), ‘birthday’ for birthdays, ‘zip’ for postal codes.
boolean
Whether this field is visible on signup forms. Defaults to true.
string
required
The unique ID for the audience/list. Get this from the List Audiences endpoint or your Mailchimp dashboard.
boolean
Whether this field is required when importing or adding contacts. Defaults to false.
string
Help text displayed below the field on signup forms to guide users.
string
The default value to use when the field is empty or null.
integer
The display order of this field on signup forms. Lower numbers appear first.
integer
For ‘text’ type fields: the default display width of the text field (in characters).
array
For ‘radio’ or ‘dropdown’ type fields: list of choices for users to select from (e.g., [‘Option 1’, ‘Option 2’, ‘Option 3’]).
string
For ‘date’ or ‘birthday’ type fields: the date format (e.g., ‘MM/DD/YYYY’, ‘DD/MM/YYYY’).
string
For ‘phone’ type fields: the format - ‘US’ for US format or ‘International’ for international format.
integer
For ‘address’ type fields: the default country code (ISO 3166-1 numeric, e.g., 840 for USA).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_ORDER_LINE_ITEMAdd a new line item to an existing order in a Mailchimp e-commerce store. Prerequisites: The store, order, product, and product variant must already exist. Use MAILCHIMP_ADD_STORE, MAILCHIMP_ADD_ORDER, and MAILCHIMP_ADD_PRODUCT to create them first if needed.

Input Parameters

string
required
A unique identifier for this order line item. Must be unique within the order (e.g., ‘line_001’, ‘item_123’).
number
required
The unit price of the line item in the store’s currency (e.g., 29.99, 100.00).
number
Optional discount amount applied to this line item in the store’s currency (e.g., 5.00 for a $5 discount).
string
required
The unique identifier for an existing order in the store. Use MAILCHIMP_LIST_ORDERS to find available order IDs.
integer
required
The quantity of items to add. Must be a positive integer (e.g., 1, 2, 5).
string
required
The unique identifier for the e-commerce store. Use MAILCHIMP_LIST_STORES to find available store IDs.
string
required
The unique identifier of the product to add to the order. The product must already exist in the store. Use MAILCHIMP_LIST_PRODUCT to find available product IDs.
string
required
The unique identifier of the specific product variant to add. Each product has at least one variant. Use MAILCHIMP_LIST_PRODUCT_VARIANTS to find available variant IDs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_OR_REMOVE_MEMBER_TAGSAdd or remove tags from a list member. Tags help organize and segment your audience. Use ‘status’: ‘active’ to add a tag, or ‘status’: ‘inactive’ to remove it. If a tag doesn’t exist and status is ‘active’, a new tag will be created. Note: Only explicitly referenced tags are updated. Sending this request does not affect tags not mentioned in the request. This endpoint returns 204 No Content on success.

Input Parameters

array
required
A list of tag objects to add or remove from the member. Each tag object must have: ‘name’ (string) - the tag name, and ‘status’ (string) - either ‘active’ to add the tag or ‘inactive’ to remove it. Example: [{‘name’: ‘VIP’, ‘status’: ‘active’}]. If a tag doesn’t exist and status is ‘active’, a new tag will be created.
string
required
The unique ID for the list (audience). You can get this from the Lists/Audiences endpoint.
boolean
When is_syncing is true, automations based on the tags in the request will not fire. Useful for bulk imports where you don’t want to trigger automations.
string
required
The MD5 hash of the lowercase version of the list member’s email address, or the member’s email address itself, or the contact_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_OR_UPDATE_CUSTOMERAdd or update a customer in a Mailchimp e-commerce store. This endpoint uses PUT semantics - if the customer exists, it will be updated; if not, a new customer will be created. The customer_id in the path and the id in the request body should match. Customers are linked to Mailchimp list members by email address.

Input Parameters

string
required
A unique identifier for the customer. Limited to 50 characters. This should match the customer_id path parameter.
string
The customer’s company name.
string
required
The unique identifier for the e-commerce store in Mailchimp.
string
The customer’s last name.
string
The customer’s first name.
string
required
The unique identifier for the customer within the store. This is used in the URL path and should match the ‘id’ field in the request body.
string
The city where the customer is located.
string
required
The customer’s email address. Must be a valid email format.
boolean
required
The customer’s opt-in status for marketing emails. Set to true to subscribe the customer to marketing, false for transactional-only. This value will never overwrite the opt-in status of a pre-existing Mailchimp list member.
string
The customer’s country name.
string
The primary street address of the customer.
string
Additional address information (apartment, suite, etc.).
string
The customer’s state or province name.
string
The customer’s postal or ZIP code.
string
The two-letter ISO country code (e.g., ‘US’, ‘CA’, ‘GB’).
string
The two-letter code for the customer’s state or province (e.g., ‘CA’, ‘NY’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_OR_UPDATE_LIST_MEMBERAdd or update a list member (subscriber) in a Mailchimp audience/list. This is an upsert operation: if the subscriber exists, they will be updated; if not, they will be created. The subscriber_hash parameter should be the MD5 hash of the lowercase email address. Note: If the list has required merge fields, use skip_merge_validation=true to bypass validation, or provide the required merge_fields values.

Input Parameters

boolean
VIP status for subscriber.
string
The IP address the subscriber used to confirm their opt-in status.
string ("subscribed" | "unsubscribed" | "cleaned" | "pending" | "transactional")
Subscriber’s current status. Values: ‘subscribed’, ‘unsubscribed’, ‘cleaned’, ‘pending’, ‘transactional’.
string
required
The unique ID for the list.
string
The subscriber’s language preference as a two-letter ISO 639-1 code (e.g., ‘en’, ‘es’, ‘fr’).
object
A dictionary of interest IDs as keys and boolean values indicating subscription to that interest. Get available interests from the list’s interest-categories endpoint.
string
IP address the subscriber signed up from.
string
Type of email this member asked to get (“html” or “text”).
object
A dictionary of merge fields where the keys are the merge tags. See the Merge Fields documentation for more about the structure.
string
required
Email address for a subscriber. This value is required only if the email address is not already present on the list.
string ("subscribed" | "unsubscribed" | "cleaned" | "pending" | "transactional")
required
Subscriber’s status when creating a new member. Required if email is not already on list. Values: ‘subscribed’, ‘unsubscribed’, ‘cleaned’, ‘pending’, ‘transactional’.
string
The date and time the subscriber confirmed their opt-in status in ISO 8601 format.
string
required
The MD5 hash of the lowercase version of the list member’s email address. This endpoint also accepts a list member’s email address or contact_id. Example: for ‘user@example.com’, use MD5(‘user@example.com’) = ‘b58996c504c5638798eb6b511e6f49af’.
string
The date and time the subscriber signed up for the list in ISO 8601 format.
number
The location latitude (e.g., 37.7749 for San Francisco).
number
The location longitude (e.g., -122.4194 for San Francisco).
array
The marketing permissions for the subscriber.
boolean
If skip_merge_validation is true, member data will be accepted without merge field values, even if the merge field is usually required. This defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_OR_UPDATE_PRODUCT_VARIANTAdd a new product variant or update an existing one in a Mailchimp e-commerce store. This endpoint uses PUT for an upsert operation - if the variant exists, it will be updated; if not, a new variant will be created. The variant_id in the URL path and the id in the request body should match. Product variants require inventory_quantity > 0 for product recommendations to work properly.

Input Parameters

string
required
A unique identifier for the product variant in the request body. Should match variant_id.
string
The stock keeping unit (SKU) of the product variant for inventory tracking.
string
The URL where the product variant can be purchased.
number
The price of the product variant in the store’s currency.
string
required
The title of the product variant (e.g., ‘Small’, ‘Red’, ‘Size 10’).
string
required
The unique identifier for the e-commerce store.
string
The URL of the product variant’s image.
string
The backorder status of the product variant.
string
required
The unique identifier for the product within the store.
string
required
The unique identifier for the product variant. Used in the URL path.
string
The visibility setting of the product variant (e.g., ‘visible’, ‘hidden’).
integer
The available inventory quantity. Must be > 0 for product recommendations to work.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_PRODUCTAdd a new product to a Mailchimp e-commerce store. Products are e-commerce items that can be added to carts and orders. Each product requires at least one variant. Products must be created before they can be included in carts or orders. For product recommendations to work properly, ensure products have a valid image_url and variants have inventory_quantity > 0.

Input Parameters

string
required
A unique identifier for the product within the store. This ID is used to reference the product in carts and orders.
string
The URL where customers can view or purchase the product.
string
The type or category of the product (e.g., ‘Clothing’, ‘Electronics’).
string
required
The display title of the product shown to customers.
string
The handle or slug for the product, typically used in URLs.
array
An array of additional product images. Each image object should include ‘id’ (unique identifier) and ‘url’ (image URL).
string
The vendor or brand name for the product. Required for segmenting campaigns by ‘Category Purchased’.
string
required
The unique identifier for the Mailchimp e-commerce store where the product will be added.
array
required
An array of product variants. At least one variant is required. Each variant object should include: ‘id’ (required, unique variant identifier), ‘title’ (required, variant name), ‘price’ (optional, decimal price), ‘inventory_quantity’ (optional, must be > 0 for recommendations). A variant can use the same ‘id’ and ‘title’ as the parent product for single-variant products.
string
The URL of the product’s main image. Required for product recommendations to display properly.
string
A text description of the product that provides details to customers.
string
The date and time the product was published in ISO 8601 format (e.g., ‘2024-01-15T10:30:00Z’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_PRODUCT_IMAGEAdd a new image to a product in a Mailchimp e-commerce store. The image must be hosted at a publicly accessible URL. You can optionally associate the image with specific product variants.

Input Parameters

string
required
A unique identifier for the product image. This should be a unique string that identifies this specific image.
string
required
The URL for the product image. Must be a valid, publicly accessible URL pointing to an image file (e.g., https://example.com/images/product.jpg).
string
required
The unique identifier for the e-commerce store. This is the store ID you created when adding the store to Mailchimp.
string
required
The unique identifier for the product within the store. This is the product ID you specified when creating the product.
array
Optional list of product variant IDs that use this image. If specified, associates the image with specific product variants.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_PROMO_CODEAdd a new promo code to an e-commerce store under an existing promo rule. A promo code contains the actual discount code that customers can apply at checkout, along with a redemption URL. You must first create a promo rule (which defines the discount type, amount, and target) before you can add promo codes to it.

Input Parameters

string
required
A unique identifier for the promo code. Restricted to UTF-8 characters with max length 50.
string
required
The discount code. Restricted to UTF-8 characters with max length 50.
boolean
Whether the promo code is currently enabled.
string
required
The unique identifier for the Mailchimp e-commerce store.
integer
Number of times promo code has been used.
string
required
The unique identifier for the promo rule. A promo code must be associated with an existing promo rule.
string
required
The url that should be used in the promotion campaign restricted to UTF-8 characters with max length 2000.
string
The date and time the promotion was created in ISO 8601 format.
string
The date and time the promotion was updated in ISO 8601 format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_PROMO_RULEAdd a new promo rule to a store. Promo rules define the parameters for promotional discounts such as percentage off, fixed amount off, or free shipping. After creating a promo rule, you can create promo codes under it using the Add Promo Code endpoint.

Input Parameters

string
required
A unique identifier for the promo rule. If your e-commerce platform does not support promo rules, use the promo code id as the promo rule id. Restricted to UTF-8 characters with max length of 50 characters.
string ("fixed" | "percentage")
required
The type of discount: ‘fixed’ for a fixed monetary amount off, or ‘percentage’ for a percentage discount. For free shipping promotions, use ‘fixed’ type with target ‘shipping’.
string
The title that will show up in promotion campaign. Restricted to UTF-8 characters with max length of 100 bytes.
number
required
The discount amount. For ‘fixed’ type, this is the monetary value (e.g., 10.00 for $10 off). For ‘percentage’ type, this must be a decimal between 0.0 and 1.0 (e.g., 0.15 for 15% off).
string ("per_item" | "total" | "shipping")
required
What the discount applies to: ‘per_item’ applies discount to each item, ‘total’ applies to the order total, ‘shipping’ applies to shipping costs (use with type ‘fixed’ for free shipping).
boolean
Whether the promo rule is currently enabled. Defaults to true if not specified.
string
The date and time when the promotion ends, in ISO 8601 format (e.g., ‘2024-12-31T23:59:59Z’). Must be after starts_at if both are specified.
string
required
The unique identifier for the e-commerce store. Use MAILCHIMP_LIST_STORES to get available store IDs.
string
The date and time when the promotion becomes active, in ISO 8601 format (e.g., ‘2024-01-15T00:00:00Z’).
string
required
The description of the promotion. Restricted to UTF-8 characters with max length of 255 characters.
string
The date and time the promotion was created in your e-commerce platform, in ISO 8601 format.
string
The date and time the promotion was last updated in your e-commerce platform, in ISO 8601 format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_SEGMENTCreate a new segment in a specific Mailchimp list/audience. Segments can be either static (based on a list of specific email addresses) or saved (based on matching conditions). For static segments, provide static_segment with email addresses. For saved segments, provide options_match and options_conditions to define the segment criteria. Note: static_segment and options fields are mutually exclusive - use one or the other.

Input Parameters

string
required
The name of the segment. Must be unique within the list.
string
required
The unique ID for the Mailchimp list/audience where the segment will be created. You can get list IDs using the ‘Get lists info’ action.
string ("any" | "all")
Match type for segment conditions. Use ‘any’ to match contacts that meet ANY condition (OR logic), or ‘all’ to match contacts that meet ALL conditions (AND logic). Required when using options_conditions.
array
An array of email addresses of existing list members to include in a static segment. Pass an empty array [] to create an empty static segment. Cannot be used together with options__match/options__conditions (use one or the other).
array
Array of condition objects for dynamic segments. Each condition should have: ‘condition_type’ (e.g., ‘EmailAddress’, ‘Merge’), ‘field’ (e.g., ‘EMAIL’), ‘op’ (e.g., ‘contains’, ‘is’), and ‘value’. Example: [{“condition_type”: “EmailAddress”, “field”: “EMAIL”, “op”: “contains”, “value”: “@gmail.com”}]. Cannot be used with static_segment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_STOREAdd a new store to your Mailchimp account.

Input Parameters

string
required
A unique client-defined identifier for the store (e.g., ‘my-store-001’). Once created, this cannot be changed.
string
required
The name of the store.
string
The store phone number.
string
The store domain. This parameter is required for Connected Sites and Google Ads.
string
required
The unique identifier for the list associated with the store. The list_id for a specific store cannot change.
string
The e-commerce platform of the store.
string
The timezone for the store in IANA format (e.g., ‘America/New_York’, ‘Europe/London’).
boolean
Whether to disable automations because the store is currently syncing.
string
The currency format for the store. For example: $, £, etc.
string
The city the store is located in.
string
required
The three-letter ISO 4217 currency code for the store (e.g., ‘USD’, ‘EUR’, ‘GBP’, ‘CAD’).
string
The email address for the store.
string
The primary locale for the store. For example: en, de, etc.
string
The store’s country name (e.g., ‘United States’, ‘Canada’).
string
The store’s mailing address (street address line 1).
string
An additional field for the store’s mailing address (street address line 2).
number
The latitude of the store location (decimal degrees, e.g., 37.7749).
string
The store’s state name or normalized province (e.g., ‘California’, ‘Ontario’).
number
The longitude of the store location (decimal degrees, e.g., -122.4194).
string
The store’s postal or zip code (e.g., ‘94102’, ‘M5V 3L9’).
string
The two-letter ISO 3166-1 alpha-2 country code for the store (e.g., ‘US’, ‘CA’).
string
The two-letter code for the store’s province or state (e.g., ‘CA’, ‘ON’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_SUBSCRIBER_TO_WORKFLOW_EMAILManually add a subscriber to a classic automation workflow email queue, bypassing the default trigger settings. This action allows you to: - Add a list member to a specific automation email’s queue - Trigger a series of automated emails in an API 3.0 workflow type - Bypass the normal trigger conditions for an automation Note: The subscriber must be a member of the list associated with the automation workflow. Returns HTTP 204 No Content on success.

Input Parameters

string
required
The unique ID of the Automation workflow. Obtain this from the list_automations action.
string
required
The email address of the subscriber to add to the workflow. The subscriber must be a member of the list associated with the automation.
string
required
The unique ID of the Automation workflow email. Obtain this from the list_automated_emails action using the workflow_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_TEMPLATECreate a new email template in the Mailchimp account. Templates can be used to create consistent email campaigns. Only Classic (HTML) templates are supported through this API endpoint. The template HTML can include Mailchimp merge tags (e.g., |FNAME|) for personalization.

Input Parameters

string
required
The raw HTML content for the template. Supports Mailchimp Template Language for dynamic content. Must be valid HTML. Example: ‘<html><body><h1>Hello |FNAME|</h1></body></html>’
string
required
The name of the template. Must be unique within the account.
string
The ID of the folder to store the template in. If not provided, the template will not be assigned to any folder.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_TEMPLATE_FOLDERCreate a new template folder in Mailchimp. Template folders help organize your email templates. Use this action to create a new folder, then add templates to it using the folder’s ID.

Input Parameters

string
required
The name of the template folder. This will be used to organize your templates within Mailchimp.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ADD_WEBHOOKCreate a new webhook for a specific Mailchimp audience/list. Creates a webhook that will receive POST notifications when specified events occur. The webhook URL must be accessible and return HTTP 200 to validation requests. Requires a Standard or Premium Mailchimp plan for webhook functionality.

Input Parameters

string
required
A valid URL endpoint that will receive webhook POST requests. Must return HTTP 200 to HEAD or POST requests.
string
required
The unique ID for the Mailchimp audience/list to add the webhook to.
boolean
Whether the webhook is triggered by actions initiated via the API.
boolean
Whether the webhook is triggered by subscriber-initiated actions.
boolean
Whether the webhook is triggered by admin-initiated actions in the web interface.
boolean
Whether the webhook is triggered when a subscriber’s email address is cleaned from the list.
boolean
Whether the webhook is triggered when a subscriber’s profile is updated.
boolean
Whether the webhook is triggered when a subscriber’s email address is changed.
boolean
Whether the webhook is triggered when a campaign is sent or cancelled.
boolean
Whether the webhook is triggered when a list subscriber is added.
boolean
Whether the webhook is triggered when a list member unsubscribes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ARCHIVE_AUTOMATIONPermanently archive a classic automation workflow in Mailchimp. IMPORTANT: This action is IRREVERSIBLE. Archiving will permanently end your automation and keep the report data. You’ll be able to replicate your archived automation, but you can’t restart it. Use this action when you want to: - Permanently stop an automation that is no longer needed - Clean up old automations while preserving historical report data - End a workflow that you don’t plan to use again Prerequisites: - The automation must exist and not already be archived - Use ‘list_automations’ to find available workflow IDs

Input Parameters

string
required
The unique identifier for the Automation workflow to archive. You can obtain this ID from the list_automations action or from the Mailchimp dashboard URL when viewing an automation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ARCHIVE_CONTACTArchive a contact in a Mailchimp audience. This action archives the specified contact, removing them from the active audience. Use when you need to archive a contact without permanently deleting their information. Returns HTTP 204 No Content on success with an empty response body.

Input Parameters

string
required
The MD5 hash of the lowercase version of the member’s email address, the member’s email address, or the contact_id.
string
required
The unique ID for the list (audience).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_ARCHIVE_LIST_MEMBERArchive (soft delete) a list member from a Mailchimp audience. This action archives the member, removing them from the active list but preserving their data. Archived members can be re-subscribed later. For permanent deletion that removes all personally identifiable information and prevents re-import, use the ‘Delete list member’ action with the delete-permanent endpoint instead. Returns HTTP 204 No Content on success with an empty response body.

Input Parameters

string
required
The unique ID for the list (audience). Can be obtained from the ‘Get lists info’ action.
string
required
The MD5 hash of the lowercase version of the list member’s email address. This endpoint also accepts a list member’s email address directly or the contact_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_BATCH_ADD_OR_REMOVE_MEMBERSBatch add or remove list members from a static segment in Mailchimp. This action allows you to efficiently manage membership in a static segment by adding and/or removing multiple email addresses in a single API call. Only works with static segments (not saved/dynamic segments based on conditions). Important notes: - At least one of members_to_add or members_to_remove must be provided - Email addresses must already exist as subscribers in the list - Non-existent emails are silently ignored (no error raised) - Maximum 500 emails can be processed per request for each operation - The segment must be a static segment (type=‘static’), not a saved segment

Input Parameters

string
required
The unique ID for the Mailchimp list/audience. Obtain this using the ‘Get lists info’ or ‘List segments’ actions.
string
required
The unique ID for the static segment. This must be a static segment, not a saved/dynamic segment. Obtain this using the ‘List segments’ action and filter by type=‘static’.
array
An array of email addresses to add to the static segment. Emails must already exist as subscribers in the list - non-existent emails are ignored. Maximum 500 emails per request. Example: [‘user1@example.com’, ‘user2@example.com’]
array
An array of email addresses to remove from the static segment. Emails not in the segment are ignored. Maximum 500 emails per request. Example: [‘user3@example.com’, ‘user4@example.com’]

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_BATCH_SUBSCRIBE_OR_UNSUBSCRIBEBatch subscribe or unsubscribe list members.

Input Parameters

string
required
The unique ID for the list.
array
required
An array of member objects. Each object must contain ‘email_address’ (string) and ‘status’ (one of: ‘subscribed’, ‘unsubscribed’, ‘cleaned’, ‘pending’, ‘transactional’). Optional fields include: ‘merge_fields’ (dict with field tags like FNAME, LNAME), ‘tags’ (list of tag names), ‘vip’ (bool), ‘language’ (string), ‘email_type’ (‘html’ or ‘text’), ‘ip_signup’ and ‘ip_opt’ (strings). Up to 500 members may be added or updated with each API call.
boolean
Whether this batch operation will replace all existing tags with tags in request.
boolean
Whether this batch operation will change existing members’ subscription status and data. Set to true to update existing members, false to only add new members. Defaults to false.
boolean
If skip_duplicate_check is true, we will ignore duplicates sent in the request when using the batch sub/unsub on the lists endpoint. The status of the first appearance in the request will be saved. This defaults to false.
boolean
If skip_merge_validation is true, member data will be accepted without merge field values, even if the merge field is usually required. This defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_CAMPAIGN_ABUSE_REPORT_DETAILSGet detailed information about a specific abuse report for a campaign. An abuse complaint occurs when your recipient reports an email as spam in their mail program. This action retrieves the details of a specific abuse report including the email address that filed the complaint, the date of the report, and associated list information. Prerequisites: - You need a valid campaign_id (use ‘list_campaigns’ to find one) - You need a valid report_id (use ‘retrieve_campaign_abuse_complaints’ to list abuse reports)

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation. Example: ‘id,email_address,date’.
string
required
The unique ID of the abuse report to retrieve. This can be obtained from the ‘retrieve_campaign_abuse_complaints’ action which lists all abuse reports for a campaign.
string
required
The unique ID of the campaign. This can be obtained from the ‘list_campaigns’ action or from campaign reports.
array
A comma-separated list of fields to exclude from the response. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_CAMPAIGN_STATISTICS_FEEDBACKGet feedback based on a campaign’s statistics. Advice feedback is based on campaign stats like opens, clicks, unsubscribes, bounces, and more.

Input Parameters

array
A list of fields to return. Reference parameters of sub-objects with dot notation (e.g., ‘advice.type’, ‘advice.message’).
string
required
The unique id for the campaign.
array
A list of fields to exclude. Reference parameters of sub-objects with dot notation (e.g., ‘_links’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_CANCEL_CAMPAIGNCancel a Regular or Plain-Text Campaign after you send, before all of your recipients receive it. This feature requires Mailchimp Pro or Premium plan. IMPORTANT: This action can only be used on campaigns that are currently in the ‘sending’ status. It cannot be used on: - Draft campaigns (status: ‘save’) - Scheduled campaigns (status: ‘schedule’) - use Unschedule Campaign instead - Already sent campaigns (status: ‘sent’) - Paused campaigns (status: ‘paused’) When successful, the campaign status will change to ‘canceling’ and then ‘canceled’. Any recipients who have already received the email will not be affected. Returns HTTP 204 No Content on success. Returns HTTP 402 Payment Required if account lacks Mailchimp Pro/Premium subscription. Returns HTTP 404 Not Found if campaign_id is invalid.

Input Parameters

string
required
The unique id for the campaign to cancel. The campaign must be in ‘sending’ status (i.e., currently being delivered but not yet complete). You can obtain campaign IDs from the List Campaigns endpoint.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_CREATE_A_SURVEY_CAMPAIGNCreate a new email campaign that links to a specific survey in Mailchimp. This action generates a campaign based on an existing survey for a given audience/list. The survey must already exist in Mailchimp before creating a campaign for it. The created campaign will include a link to the survey, allowing recipients to participate. Prerequisites: - A valid Mailchimp audience/list (use ‘Get lists info’ to retrieve available lists) - An existing survey for that list (use ‘Get information about all surveys for a list’ to retrieve surveys) Returns the created campaign details including campaign ID, status, recipients, and settings.

Input Parameters

string
required
The unique ID for the Mailchimp audience/list. This is a 10-character alphanumeric string (e.g., ‘abc1234567’). You can obtain this from the ‘Get lists info’ action or from the Mailchimp dashboard.
string
required
The unique ID for the survey to create a campaign for. This is a 10-character alphanumeric string (e.g., ‘xyz9876543’). You can obtain this from the ‘Get information about all surveys for a list’ action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_CUSTOMER_JOURNEYS_API_TRIGGER_FOR_A_CONTACTTrigger a Customer Journey step for a specific contact via the Mailchimp API. This endpoint allows you to programmatically activate an API trigger step in a Customer Journey for a given contact. Before using this action: 1. Create a Customer Journey in the Mailchimp app with an “API Trigger” as a starting point or step 2. Mailchimp will provide you with a URL containing the journey_id and step_id 3. Use those IDs along with the contact’s email address to trigger the journey The contact must be a member of the audience associated with the Customer Journey. Returns HTTP 204 (No Content) on success with an empty response body.

Input Parameters

integer
required
The unique identifier for the step within the Customer Journey. This ID is provided by Mailchimp when you create an API trigger step in the Customer Journey builder.
integer
required
The unique identifier for the Customer Journey. This ID is provided by Mailchimp when you create an API trigger step in the Customer Journey builder.
string
required
The email address of the contact to trigger in the Customer Journey. The contact must be a member of the audience associated with the journey.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_CUSTOMIZE_SIGNUP_FORMCustomize the appearance and content of a Mailchimp list’s signup form. Use this action to modify the header text/image, body content sections, and CSS styles of the embedded signup form for a specific audience/list. The signup form is used to collect email subscriptions from website visitors.

Input Parameters

array
List of style customizations for form elements. Each item should have ‘selector’ (e.g., ‘page_background’, ‘body_link_style’) and ‘options’ (list of CSS property/value pairs like [{‘property’: ‘background-color’, ‘value’: ‘#ffffff’}]).
string
required
The unique ID for the Mailchimp list/audience whose signup form you want to customize.
array
List of content sections for the signup form body. Each item should have ‘section’ (e.g., ‘signup_message’) and ‘value’ (the text content) keys.
string
The title/heading text displayed at the top of the signup form (e.g., ‘Subscribe to Our Newsletter’).
string
Alternative text for the header image, used for accessibility and when the image cannot be displayed.
string
URL of the header image to display at the top of the signup form. Must be a publicly accessible image URL.
URL that users will be directed to when clicking the header image.
string ("none" | "left" | "center" | "right")
Horizontal alignment of the header image. Options: ‘none’, ‘left’, ‘center’, ‘right’.
string
Width of the header image in pixels (e.g., ‘200’).
string
Height of the header image in pixels (e.g., ‘100’).
string ("_blank" | "null")
Target window for the header image link. ‘_blank’ opens in new tab, ‘null’ opens in same window.
string
Color of the header image border in hex format (e.g., ‘#000000’ for black).
string ("none" | "solid" | "dotted" | "dashed" | "double" | "groove" | "outset" | "inset" | "ridge")
CSS border style for the header image. Options: ‘none’, ‘solid’, ‘dotted’, ‘dashed’, ‘double’, ‘groove’, ‘outset’, ‘inset’, ‘ridge’.
string
Width of the border around the header image in pixels (e.g., ‘2’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_BATCH_REQUESTStops a batch request from running. Since only one batch request is run at a time, this can be used to cancel a long running request. The results of any completed operations will not be available after this call.

Input Parameters

string
required
The unique ID of the batch operation to stop/delete. This ID is returned when you create a batch request using the ‘Start batch operation’ endpoint.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_BATCH_WEBHOOKPermanently delete a batch webhook by its ID. Once deleted, the webhook URL will no longer receive POST notifications when batch operations complete. Use this action to remove webhooks that are no longer needed or to clean up invalid webhook endpoints. This action is idempotent - deleting a non-existent webhook returns a 404 error. Related actions: - list_batch_webhooks: Get all configured batch webhooks to find the ID - add_batch_webhook: Create a new batch webhook - update_batch_webhook: Modify an existing batch webhook’s settings

Input Parameters

string
required
The unique identifier for the batch webhook to delete. This ID can be obtained from the ‘list_batch_webhooks’ action or from the response of ‘add_batch_webhook’. Example: ‘1537c038e7’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_CAMPAIGNPermanently delete a campaign from your Mailchimp account. This action removes the specified campaign and all associated data. Note: Only campaigns with ‘save’ or ‘paused’ status can be deleted. Campaigns that have been sent cannot be deleted.

Input Parameters

string
required
The unique identifier for the campaign to delete. This can be obtained from the campaign list or campaign creation response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_CAMPAIGN_FEEDBACK_MESSAGERemove a specific feedback message for a campaign.

Input Parameters

string
required
The unique id for the campaign. Can be obtained from the list_campaigns action.
string
required
The unique id for the feedback message to delete. Can be obtained from the list_campaign_feedback or add_campaign_feedback actions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_CAMPAIGN_FOLDERDelete a specific campaign folder from Mailchimp. When a campaign folder is deleted, all campaigns within that folder are automatically marked as ‘unfiled’ rather than being deleted. This operation is idempotent - deleting an already-deleted folder will return an error indicating the folder was not found. Returns HTTP 204 No Content on success.

Input Parameters

string
required
The unique identifier for the campaign folder to delete. This ID can be obtained from the list_campaign_folders or add_campaign_folder actions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_CARTDelete a cart from an e-commerce store. This endpoint permanently removes a cart and all its line items from the specified store. Use this when a cart is no longer needed (e.g., after converting it to an order or when the customer has abandoned the checkout process). Note: Deleting a cart will cancel any pending abandoned cart automation emails associated with it. Carts do not automatically expire and will remain until deleted.

Input Parameters

string
required
The unique identifier for the cart to delete. This is the cart ID that was assigned when the cart was created. You can find cart IDs using the List Carts endpoint.
string
required
The unique identifier for the e-commerce store. This is the store ID you defined when creating the store using the Add Store endpoint.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_CART_LINE_ITEMDelete a specific line item from a cart in a Mailchimp e-commerce store. Cart line items represent products that a customer has added to their shopping cart. This action permanently removes a line item from the specified cart. The deletion cannot be undone - to restore the item, you would need to add it again using ‘add_cart_line_item’. Use this action when: - A customer removes an item from their cart - You need to clear invalid or outdated line items - Syncing cart changes from your e-commerce platform to Mailchimp Note: If you need to delete the entire cart, use ‘delete_cart’ instead.

Input Parameters

string
required
The unique identifier for the cart containing the line item. You can get this from the ‘list_carts’ action or from the response when creating a cart.
string
required
The unique identifier for the line item to delete. You can get this from the ‘list_cart_line_items’ action or from the ‘lines’ array in cart details.
string
required
The unique identifier for the e-commerce store. You can get this from the ‘list_stores’ action or from the response when creating a store.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_CONNECTED_SITERemove a connected site from your Mailchimp account. This action permanently deletes the specified connected site. Connected sites are external websites that have been linked to your Mailchimp account for tracking and integration purposes. Once deleted, the site tracking script will no longer collect data for this site. Note: This action is idempotent - deleting an already-deleted site will not cause an error but may return a 404 Not Found response.

Input Parameters

string
required
The unique identifier for the connected site to delete. This ID can be obtained from the List Connected Sites or Get Connected Site actions (returned as ‘foreign_id’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_CUSTOMERDelete a customer from an e-commerce store. Permanently removes a customer record from the specified Mailchimp store. This action is destructive and cannot be undone. The customer’s associated data including order history linkage will be removed, but existing orders will not be deleted. Returns HTTP 204 No Content on successful deletion.

Input Parameters

string
required
The unique identifier for the e-commerce store. This is the ID assigned when the store was created in Mailchimp.
string
required
The unique identifier for the customer within the store. This is the customer ID that was assigned when the customer was added to the store.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_DOMAINDelete a sending domain from the Mailchimp account’s verified domains. This permanently removes a domain that was previously added for verification. The domain can be in any verification state (pending, verified, or authenticated). After deletion, the domain will no longer appear in the verified-domains list and cannot be used as a sender address until re-added and re-verified. Use ‘list_sending_domains’ to see available domains before deletion.

Input Parameters

string
required
The verified domain name to delete from the Mailchimp account (e.g., ‘example.com’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_FILEPermanently remove a file from the Mailchimp File Manager. This action deletes an image or document file from your Mailchimp account’s File Manager. Once deleted, the file cannot be recovered. Files in the File Manager are typically used in campaigns, templates, or signup forms. IMPORTANT: This is a destructive action. Ensure you have the correct file_id before executing, as deletion is permanent. Files that are actively used in campaigns may still be accessible until those campaigns are deleted.

Input Parameters

string
required
The unique numeric ID of the file to delete from the File Manager. You can get this ID from the ‘List stored files’ action or from the ‘Add file’ action response when uploading a new file.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_FOLDERDelete a specific folder in the File Manager. This permanently removes the folder and all files contained within it. Use with caution as this action cannot be undone.

Input Parameters

string
required
The unique ID of the File Manager folder to delete. This can be obtained from the list_folders action or from the response when creating a folder.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_INTEREST_CATEGORYDelete a specific interest category from a Mailchimp audience/list. Interest categories are used to group related interests together on signup forms (e.g., ‘Newsletter Preferences’, ‘Product Interests’). Each category can contain multiple interests that subscribers can select. WARNING: This action permanently deletes the interest category and all interests within it. This cannot be undone. Any subscriber data associated with these interests will also be removed. Use this action when you need to: - Remove obsolete or unused interest categories - Clean up test data - Reorganize your list’s interest structure Prerequisites: - Obtain the list_id using ‘Get lists info’ action - Obtain the interest_category_id using ‘List interest categories’ action

Input Parameters

string
required
The unique ID for the Mailchimp audience/list containing the interest category. This is a 10-character alphanumeric string (e.g., ‘2cc9d141a8’). Retrieve available list IDs using the ‘Get lists info’ action.
string
required
The unique ID for the interest category to delete. This is a 10-character alphanumeric string (e.g., ‘a788d2f60b’). Retrieve available interest category IDs using the ‘List interest categories’ action. Note: Deleting an interest category will also delete all interests within it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_INTEREST_IN_CATEGORYDelete a specific interest (group name) from an interest category within a Mailchimp list. This permanently removes the interest from the category. Returns HTTP 204 on success.

Input Parameters

string
required
The unique ID for the list (audience) containing the interest category.
string
required
The unique ID of the interest to delete within the category.
string
required
The unique ID for the interest category containing the interest to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_LANDING_PAGEPermanently delete a Mailchimp landing page. This action permanently removes a landing page from your Mailchimp account. This operation cannot be undone. The landing page must exist and be in a deletable state (draft or unpublished). Published landing pages should be unpublished first before deletion. Returns a 204 No Content response on success, indicating the page was deleted. Returns a 404 error if the page_id does not exist.

Input Parameters

string
required
The unique identifier for the landing page to delete. This is a 12-character hexadecimal string (e.g., ‘030001b4e1f0’). Use the List Landing Pages action to retrieve available page IDs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_LISTPermanently delete a list (audience) from your Mailchimp account. WARNING: This is a destructive and irreversible operation. Deleting a list will permanently remove all associated data including: - Subscriber email addresses and profile data - Subscriber activity history (opens, clicks, etc.) - Unsubscribe records - Complaint records - Bounce records - Segments and tags Export and backup your list data before deletion if needed. Returns HTTP 204 No Content on success.

Input Parameters

string
required
The unique ID for the list (audience) to delete. This is a 10-character alphanumeric string (e.g., ‘2cc9d141a8’). Can be obtained from the GET /lists endpoint or list settings in Mailchimp.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_LIST_MEMBERPermanently delete a list member and all their personally identifiable information (PII). WARNING: This is an irreversible action. Once deleted, the member cannot be re-imported with the same email address. Use this for GDPR compliance or when permanently removing a contact. For soft removal (keeping the ability to re-add later), use archive_list_member instead. Returns HTTP 204 No Content on success with an empty response body.

Input Parameters

string
required
The unique ID for the Mailchimp audience/list (e.g., ‘abc123def4’). Can be obtained from the list_lists or get_lists_info actions.
string
required
The MD5 hash of the lowercase version of the list member’s email address. For example, for ‘User@Example.com’, compute MD5 of ‘user@example.com’. This hash is also returned as ‘id’ when adding or listing members.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_MERGE_FIELDDelete a specific merge field (audience field) from a Mailchimp list/audience. WARNING: This action permanently deletes the merge field and all associated data collected from that field. This cannot be undone. Consider hiding the field from signup forms instead of deleting it. Back up your audience data before deleting. Note: Default merge fields (FNAME, LNAME, ADDRESS, PHONE) cannot be deleted.

Input Parameters

string
required
The unique ID for the audience/list. Get this from the List Audiences endpoint (MAILCHIMP_GET_LISTS_INFO) or your Mailchimp dashboard.
string
required
The numeric ID for the merge field to delete. Get this from the List Merge Fields endpoint (MAILCHIMP_LIST_MERGE_FIELDS). Note: Default fields like FNAME, LNAME, ADDRESS, and PHONE cannot be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_NOTEDelete a specific note for a list member in Mailchimp. Permanently removes a note associated with a subscriber. This operation cannot be undone. A successful deletion returns HTTP 204 No Content. To delete a note, you need: - list_id: The unique ID of the Mailchimp audience/list - subscriber_hash: The member’s email address, MD5 hash of lowercase email, or contact_id - note_id: The unique ID of the note (can be obtained from list_recent_member_notes)

Input Parameters

string
required
The unique ID for the Mailchimp list (audience).
string
required
The unique ID of the note to delete.
string
required
The MD5 hash of the lowercase version of the list member’s email address. This endpoint also accepts the member’s email address or contact_id directly.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_ORDERPermanently delete an order from a Mailchimp e-commerce store. This action removes the order and its associated line items. This operation cannot be undone.

Input Parameters

string
required
The unique identifier for the order to delete within the specified store.
string
required
The unique identifier for the e-commerce store containing the order to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_ORDER_LINE_ITEMDelete a specific line item from an order in a Mailchimp e-commerce store. This action permanently removes the specified line item from the order. The operation is idempotent - deleting an already-deleted line item returns the same success response. Prerequisites: The store, order, and line item must exist. Use MAILCHIMP_LIST_STORES, MAILCHIMP_LIST_ORDERS, and MAILCHIMP_LIST_ORDER_LINE_ITEMS to find valid IDs. Note: This action cannot be undone. To add the line item back, use MAILCHIMP_ADD_ORDER_LINE_ITEM.

Input Parameters

string
required
The unique identifier for the line item to delete from the order. Use MAILCHIMP_LIST_ORDER_LINE_ITEMS to find available line item IDs.
string
required
The unique identifier for an order within the store. Use MAILCHIMP_LIST_ORDERS to find available order IDs for a store.
string
required
The unique identifier for the e-commerce store. Use MAILCHIMP_LIST_STORES to find available store IDs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_PRODUCTPermanently delete a product from a Mailchimp e-commerce store. This action removes the product and all its variants. Returns HTTP 204 on success with no content. Use LIST_STORES to find store IDs and LIST_PRODUCT to find product IDs. This operation cannot be undone.

Input Parameters

string
required
The unique identifier for the e-commerce store. Use LIST_STORES to find available store IDs.
string
required
The unique identifier for the product to delete. Use LIST_PRODUCT to find available product IDs for a store.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_PRODUCT_IMAGEDelete a product image from a Mailchimp e-commerce store. This action permanently removes an image associated with a product. The operation is idempotent - deleting an already-deleted image will not cause an error. Before deleting, ensure you have the correct store_id, product_id, and image_id as this action cannot be undone.

Input Parameters

string
required
The unique identifier for the product image to delete. This is the image ID you specified when adding the image to the product.
string
required
The unique identifier for the e-commerce store. This is the store ID you specified when adding the store to Mailchimp.
string
required
The unique identifier for the product within the store. This is the product ID you specified when creating the product.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_PRODUCT_VARIANTDelete a specific product variant from a Mailchimp e-commerce store. This action permanently removes a variant from a product. Use this to clean up discontinued variants or manage product options. Note that a product must always have at least one variant, so attempting to delete the last remaining variant of a product will fail. Prerequisites: - The store must exist (use list_stores to verify) - The product must exist in the store (use list_product to verify) - The variant must exist and not be the only variant for the product

Input Parameters

string
required
The unique identifier for the Mailchimp e-commerce store containing the product variant to delete.
string
required
The unique identifier for the product that contains the variant to be deleted.
string
required
The unique identifier for the specific product variant to delete. Note: A product must have at least one variant, so deleting the last variant may fail.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_PROMO_CODEDelete a promo code from an e-commerce store. This action permanently removes a specific promo code from a promo rule in a Mailchimp store. The promo code will no longer be available for customers to use. This action is idempotent - deleting an already-deleted promo code will not cause an error. Prerequisites: - The store must exist (use MAILCHIMP_LIST_STORES to verify) - The promo rule must exist in the store (use MAILCHIMP_LIST_PROMO_RULES to verify) - The promo code must exist within the promo rule (use MAILCHIMP_LIST_PROMO_CODES to verify) Note: This action is destructive and cannot be undone. The promo code will need to be recreated using MAILCHIMP_ADD_PROMO_CODE if you want to restore it.

Input Parameters

string
required
The unique identifier for the e-commerce store. Use MAILCHIMP_LIST_STORES to retrieve available store IDs.
string
required
The unique identifier for the promo code to delete. Use MAILCHIMP_LIST_PROMO_CODES to retrieve available promo code IDs for a promo rule.
string
required
The unique identifier for the promo rule that contains the promo code. Use MAILCHIMP_LIST_PROMO_RULES to retrieve available promo rule IDs for a store.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_PROMO_RULEPermanently delete a promo rule from a Mailchimp e-commerce store. This action also removes all associated promo codes. Warning: This operation is irreversible. Returns HTTP 204 on success with no content body.

Input Parameters

string
required
The unique identifier for the e-commerce store containing the promo rule to delete. Use MAILCHIMP_LIST_STORES to find available store IDs.
string
required
The unique identifier for the promo rule to delete. Use MAILCHIMP_LIST_PROMO_RULES to find promo rule IDs for a specific store.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_SEGMENTPermanently delete a segment from a Mailchimp list (audience). This action removes the segment definition from the list. It does NOT delete the contacts/members within the segment - they remain in the list. Both static segments and saved segments can be deleted using this action. Note: This is a destructive operation that cannot be undone. Use with caution.

Input Parameters

string
required
The unique ID for the Mailchimp list (audience) containing the segment. You can retrieve list IDs using the ‘Get lists info’ action.
string
required
The unique ID of the segment to delete. You can retrieve segment IDs using the ‘List segments’ action. This can be either a saved segment (based on conditions) or a static segment (based on specific email addresses).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_STOREDelete an e-commerce store from your Mailchimp account. WARNING: This is a destructive operation. Deleting a store will permanently remove all associated subresources, including Customers, Orders, Products, and Carts. This action cannot be undone. Returns HTTP 204 No Content on successful deletion.

Input Parameters

string
required
The unique identifier for the e-commerce store to delete. This is the client-defined ID that was provided when the store was created (e.g., ‘my-store-001’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_TEMPLATEPermanently delete a user-created email template from your Mailchimp account. This action removes the specified template and cannot be undone. Only templates of type ‘user’ (custom templates you created) can be deleted. System templates and gallery templates cannot be deleted. Returns HTTP 204 No Content on success. Returns HTTP 404 if the template does not exist or is not a user template.

Input Parameters

string
required
The unique numeric ID for the template to delete. Only user-created templates can be deleted; system/gallery templates cannot be deleted. Use the List Templates action to find available template IDs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_TEMPLATE_FOLDERPermanently delete a template folder from your Mailchimp account. This action removes a specific template folder. Any email templates that were stored in the folder will not be deleted, but will be marked as ‘unfiled’ and can still be accessed through the templates list. Important: This is a destructive action and cannot be undone. Make sure you have the correct folder_id before executing. Returns HTTP 204 No Content on successful deletion.

Input Parameters

string
required
The unique ID of the template folder to delete. This is a 10-character alphanumeric string (e.g., ‘1033a6ad30’). You can obtain this ID from the ‘list_template_folders’ or ‘add_template_folder’ actions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_WEBHOOKDelete a specific webhook from a Mailchimp audience/list. Permanently removes a webhook configuration that was previously set up to receive POST notifications for list events. This action is irreversible - once deleted, the webhook URL will no longer receive notifications. Returns the deleted webhook object with its configuration details.

Input Parameters

string
required
The unique ID for the Mailchimp audience/list containing the webhook to delete.
string
required
The unique identifier for the webhook to delete. Can be obtained from the list webhooks endpoint.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_DELETE_WORKFLOW_EMAILPermanently delete an email from a classic automation workflow. This action removes the specified email from an automation workflow. Important limitations: - Emails from Abandoned Cart (abandonedCart) workflows cannot be deleted. - Emails from Product Retargeting (abandonedBrowse) workflows cannot be deleted. - The automation workflow must exist and contain the specified email. Use the list_automations action to get valid workflow_id values. Use the list_automated_emails action to get valid workflow_email_id values.

Input Parameters

string
required
The unique identifier for the Automation workflow. This can be obtained from the list automations endpoint or automation creation response.
string
required
The unique identifier for the Automation workflow email to delete. This can be obtained from the list automated emails endpoint.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_FORGET_CONTACTForget a contact and remove their personally identifiable information (PII). This action marks a contact to be forgotten and initiates the process to remove their PII from Mailchimp in compliance with GDPR and privacy regulations. Use this when handling “right to be forgotten” requests. The contact will be permanently removed from the audience. Returns HTTP 204 No Content on success with an empty response body.

Input Parameters

string
required
The unique ID for the contact. This can be the MD5 hash of the lowercase email address, the contact_id, or the subscriber_hash.
string
required
The unique ID for the audience (list). Can be obtained from the get_lists_info action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_ABUSE_REPORTGet details about a specific abuse report.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation. Example: ‘id,email_address,date’.
string
required
The unique ID for the list/audience.
string
required
The unique ID for the abuse report.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation. Cannot be used with ‘fields’ parameter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_ACCOUNT_EXPORT_INFOGet detailed information about a specific Mailchimp account export. Use this action to check the status of an export job and retrieve the download URL once it’s complete. Exports can take anywhere from a few minutes to several hours depending on account size. Typical workflow: 1. Create an export using ‘add_export’ action 2. Poll this action periodically to check the ‘finished’ status 3. Once ‘finished’ is True, use the ‘download_url’ to download the ZIP file Note: The download_url is signed and provides direct access to your data without authentication. Keep this URL secure. Completed exports are available for download for up to 90 days.

Input Parameters

array
Optional list of fields to include in the response. Use dot notation for nested fields (e.g., [‘export_id’, ‘finished’, ‘download_url’, ‘stages.status’]). If not specified, all fields are returned.
string
required
The unique identifier for the account export. This ID is returned when creating an export via ‘add_export’ or can be obtained from ‘list_account_exports’.
array
Optional list of fields to exclude from the response. Use dot notation for nested fields (e.g., [‘_links’]). Cannot be used together with ‘fields’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_AUDIENCES_CONTACTSTool to get a list of omni-channel contacts for a given audience. Use when you need to retrieve contacts from a Mailchimp audience with optional filtering and pagination.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000.
string
Paginate through a collection of records by setting the cursor parameter to a next_cursor attribute returned by a previous request. Default value fetches the first page of results.
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
string ("ASC" | "DESC")
Enum for sort_dir parameter
string ("created_at" | "updated_at")
Enum for sort_field parameter
string
required
The unique ID for the audience.
string
Restricts the response to contacts created after the specified time (exclusive). Uses ISO 8601 format: 2025-04-23T15:41:36+00:00.
string
Restricts the response to contacts updated after the specified time (exclusive). Uses ISO 8601 format: 2025-04-23T15:41:36+00:00.
string
Restricts the response to contacts created at or before the specified time (inclusive). Uses ISO 8601 format: 2025-04-23T15:41:36+00:00.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
string
Restricts the response to contacts updated at or before the specified time (inclusive). Uses ISO 8601 format: 2025-04-23T15:41:36+00:00.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_AUDIENCES_CONTACTS_DETAILTool to retrieve a specific omni-channel contact from a Mailchimp audience by their ID or channel hash. Use when you need detailed information about a contact including email/SMS channels, merge fields, tags, and subscription status.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
string
required
A unique identifier for the contact, which can be a Mailchimp contact ID or a channel hash. A channel hash must follow the format email:[md5_hash] (where the hash is the MD5 of the lowercased email address) or sms:[sha256_hash] (where the hash is the SHA256 of the E.164-formatted phone number).
string
required
The unique ID for the audience.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_AUTHORIZED_APP_INFORetrieve detailed information about a specific authorized OAuth application. Returns the app’s ID, name, description, and list of users who have linked their Mailchimp accounts to this application. Use LIST_AUTHORIZED_APPS first to get valid app_id values.

Input Parameters

string
required
The unique numeric ID of the authorized application. Obtain this from the LIST_AUTHORIZED_APPS action.
array
A list of fields to return in the response. Use dot notation for nested fields (e.g., [‘id’, ‘name’, ‘description’]). If not specified, all fields are returned.
array
A list of fields to exclude from the response. Use dot notation for nested fields (e.g., [‘_links’]). Cannot be used with ‘fields’ parameter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_AUTOMATED_EMAIL_SUBSCRIBERGet information about a specific subscriber in a classic automation email queue. This action retrieves details about a subscriber who is waiting to receive an automated email, including their email address and the scheduled send time. Note: Subscribers appear in the queue when they’ve been triggered by the automation but haven’t yet received the email. The queue is typically processed quickly, so subscribers may only be in the queue briefly. Returns HTTP 404 if the subscriber is not found in the queue.

Input Parameters

string
required
The unique ID for the Automation workflow. Can be obtained from list_automations action.
string
required
The MD5 hash of the lowercase version of the list member’s email address.
string
required
The unique ID for the Automation workflow email. Can be obtained from list_automated_emails action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_AUTOMATION_INFORetrieve details of a Mailchimp automation workflow by its ID. Returns comprehensive information including: - Basic info: ID, status (save/paused/sending/archived), creation time - Settings: title, from_name, reply_to email - Recipients: associated list/audience ID, store ID for e-commerce automations - Tracking: opens, clicks, e-commerce tracking configuration - Report summary: opens, clicks, rates (for archived automations) Use MAILCHIMP_LIST_AUTOMATIONS to get available workflow IDs.

Input Parameters

array
A list of fields to return. Reference parameters of sub-objects with dot notation. Example: [‘id’, ‘settings.title’, ‘recipients.list_id’]
string
required
The unique id for the Automation workflow. Can be obtained from the list_automations action.
array
A list of fields to exclude from the response. Reference parameters of sub-objects with dot notation. Example: [‘_links’, ‘tracking’]

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_BATCH_OPERATION_STATUSGet the status of a batch operation. Retrieves details about a specific batch operation including its current status (pending, preprocessing, started, finalizing, or finished), operation counts, timestamps, and a URL to download the results when completed.

Input Parameters

array
A list of fields to return. Use dot notation for sub-object fields (e.g., [‘id’, ‘status’, ‘total_operations’]). If not specified, all fields are returned.
string
required
The unique ID for the batch operation. Obtain this from list_batch_requests or start_batch_operation.
array
A list of fields to exclude from the response. Use dot notation for sub-object fields (e.g., [‘_links’]).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_BATCH_WEBHOOK_INFORetrieve detailed information about a specific batch webhook by its ID. Batch webhooks are used to receive notifications when batch operations complete. Use this endpoint to check the configuration and status of a specific webhook.

Input Parameters

array
A list of fields to return in the response. Use dot notation to reference sub-object parameters (e.g., [‘id’, ‘url’, ‘enabled’]). If not specified, all fields are returned.
array
A list of fields to exclude from the response. Use dot notation to reference sub-object parameters (e.g., [‘_links’]). Cannot be used together with ‘fields’.
string
required
The unique identifier for the batch webhook. This can be obtained from the list batch webhooks endpoint.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_CAMPAIGN_CONTENTGet the HTML and plain-text content for a campaign.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
string
required
The unique id for the campaign.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_CAMPAIGN_FEEDBACK_MESSAGEGet a specific feedback message from a campaign.

Input Parameters

array
A list of fields to return. Reference parameters of sub-objects with dot notation. Available fields: feedback_id, parent_id, block_id, message, is_complete, created_by, created_at, updated_at, source, campaign_id, _links.
string
required
The unique id for the campaign. Obtain from MAILCHIMP_LIST_CAMPAIGNS.
string
required
The unique id for the feedback message. Obtain from MAILCHIMP_LIST_CAMPAIGN_FEEDBACK or MAILCHIMP_ADD_CAMPAIGN_FEEDBACK.
array
A list of fields to exclude from the response. Reference parameters of sub-objects with dot notation. Example: [‘_links’] to exclude HATEOAS links.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_CAMPAIGN_FOLDERGet information about a specific folder used to organize campaigns in Mailchimp. Returns the folder details including its ID, name, and the count of campaigns stored within it. Use the ‘list_campaign_folders’ action to get available folder IDs.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation. Example: ‘id,name,count’ to only return those fields.
string
required
The unique ID for the campaign folder. This can be obtained from the ‘list_campaign_folders’ action.
array
A comma-separated list of fields to exclude from the response. Reference parameters of sub-objects with dot notation. Example: ‘_links’ to exclude links from response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_CAMPAIGN_INFOGet information about a specific campaign.

Input Parameters

array
A list of fields to return. Reference parameters of sub-objects with dot notation. Example: [‘id’, ‘status’, ‘settings.title’, ‘recipients.list_id’]. If not specified, all fields are returned.
string
required
The unique id for the campaign.
array
A list of fields to exclude from the response. Reference parameters of sub-objects with dot notation. Example: [‘_links’, ‘tracking’]. Cannot be used together with ‘fields’.
boolean
Return the resend_shortcut_eligibility field in the response, which tells you if the campaign is eligible for the various Campaign Resend Shortcuts offered.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_CAMPAIGN_RECIPIENT_INFOGet information about a specific campaign recipient.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation. Example: ‘email_address,status,open_count’.
string
required
The unique id for the campaign. This must be a campaign that has been sent to have recipient data.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation. Example: ‘_links,merge_fields’.
string
required
The MD5 hash of the lowercase version of the list member’s email address. You can compute this using: md5(email_address.lower()). Also known as email_id in list endpoints.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_CAMPAIGN_REPORTRetrieve detailed performance report for a Mailchimp campaign. Returns analytics including email delivery stats (sent, bounced), engagement metrics (opens, clicks), and e-commerce data (orders, revenue). Works for both sent campaigns (with actual data) and draft campaigns (returns zeros).

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation (e.g., ‘opens.opens_total,clicks.click_rate’).
string
required
The unique ID of the sent campaign to retrieve the report for.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation (e.g., ‘industry_stats,timeseries’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_CAMPAIGN_SEND_CHECKLISTReview the send checklist for a Mailchimp campaign before sending. Returns a list of checklist items indicating issues that need to be resolved. Each item has a ‘type’ field: ‘error’ (must fix before sending), ‘warning’ (optional but recommended to address), or ‘success’ (item is complete). The ‘is_ready’ field indicates if the campaign can be sent (True when no errors). Common checklist items include: audience selection, subject line, from name/email, email content, and tracking settings.

Input Parameters

array
List of fields to return. Available fields: ‘is_ready’, ‘items’, ‘_links’. Use dot notation for nested fields (e.g., ‘items.type’, ‘items.heading’).
string
required
The unique ID for the campaign. Obtain this from list_campaigns or add_campaign actions.
array
List of fields to exclude from the response. Common use: exclude ‘_links’ to reduce response size.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_CART_INFORetrieve detailed information about a specific cart in an e-commerce store, including customer details and line items.

Input Parameters

array
A list of fields to return. Use dot notation for sub-object fields (e.g., ‘customer.email_address’, ‘lines.product_id’).
string
required
The unique identifier for the cart to retrieve.
string
required
The unique identifier for the e-commerce store containing the cart.
array
A list of fields to exclude from the response. Use dot notation for sub-object fields (e.g., ‘_links’, ‘customer._links’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_CART_LINE_ITEMRetrieve detailed information about a specific line item in a shopping cart. Returns product details, variant information, quantity, and price for a single cart line item. Useful for displaying cart item details or verifying cart contents before checkout.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation. Available fields include: id, product_id, product_title, product_variant_id, product_variant_title, quantity, price, _links.
string
required
The unique identifier for the cart. Obtain this from the list_carts action for a given store.
string
required
The unique identifier for the line item within the cart. Obtain this from list_cart_line_items action.
string
required
The unique identifier for the e-commerce store. Obtain this from the list_stores action.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation. Use this to reduce response size by excluding unwanted fields.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_CONNECTED_SITERetrieve information about a specific connected site in your Mailchimp account. Connected sites allow Mailchimp to track website activity and visitor behavior for your email marketing campaigns. Use this action to get details about a site including its domain, platform type, and the JavaScript tracking snippet. Returns the site’s foreign_id, domain, platform, tracking script (site_script), and creation/update timestamps.

Input Parameters

array
A list of fields to return in the response. Available fields include: ‘foreign_id’, ‘store_id’, ‘platform’, ‘domain’, ‘site_script’, ‘site_script.url’, ‘site_script.fragment’, ‘created_at’, ‘updated_at’, ‘_links’. Use dot notation for nested fields (e.g., ‘site_script.url’).
array
A list of fields to exclude from the response. Use same field names as ‘fields’ parameter. Useful for omitting large fields like ‘site_script’ or ‘_links’ when not needed.
string
required
The unique identifier (foreign_id) of the connected site to retrieve. This is the same ID used when the site was created via add_connected_site. Example: ‘site_123’, ‘my-shop-456’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_CONVERSATIONAPI endpoint for Conversations is deprecated, replaced by Inbox. Although historical data is accessible, new campaign replies and messages are not retrievable through this endpoint.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
string
required
The unique id for the conversation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_CUSTOMER_INFOGet information about a specific customer.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
string
required
The unique identifier for the e-commerce store.
string
required
The unique identifier for the customer within the specified store.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_DOMAIN_INFOGet the details for a single verified domain on the Mailchimp account. Retrieves information about a specific domain including its verification status, authentication status, and the email address used for verification. Use this action to check if a domain has been verified and is ready for sending emails. Returns 404 if the domain is not found in the account’s verified domains list.

Input Parameters

string
required
The domain name to retrieve information for (e.g., ‘example.com’). This should be a domain that has been previously added to your Mailchimp account via the add_domain_to_account action. Use list_sending_domains to see all available domains.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_FACEBOOK_AD_INFORetrieve detailed information about a specific Facebook ad created through Mailchimp. Returns ad details including id, name, web_id, channel_id (e.g., ‘fb’), type, status (e.g., ‘paused’, ‘active’, ‘disconnected’), audience targeting information, budget settings, content, create_time, start_time, end_time, and feedback data. Note: Facebook ads must be created through Mailchimp’s Facebook Ad Campaigns feature. To get the outreach_id, first use the list_facebook_ads action to retrieve available ads.

Input Parameters

array
A list of fields to return. Reference sub-object parameters with dot notation. Example: [‘id’, ‘name’, ‘status’, ‘audience.email_source’]. If not specified, all fields are returned.
string
required
The unique identifier for the Facebook ad. This ID can be obtained from the list_facebook_ads action response, where it is returned as the ‘id’ field for each ad.
array
A list of fields to exclude from the response. Reference sub-object parameters with dot notation. Example: [‘_links’]. Cannot be used together with ‘fields’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_FACEBOOK_AD_REPORTRetrieve detailed performance report for a specific Facebook ad campaign. Returns comprehensive metrics including impressions, clicks, reach, engagement, budget information, content details, and ecommerce performance data. The report provides insights into ad effectiveness and ROI. Note: Requires a valid outreach_id which can be obtained from the list_facebook_ads or list_facebook_ads_reports endpoints.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation (e.g., ‘report_summary.opens’, ‘budget.amount’). If not specified, all fields are returned.
string
required
The unique identifier of the Facebook ad to retrieve the report for. This ID can be obtained from the list_facebook_ads or list_facebook_ads_reports endpoints.
array
A comma-separated list of fields to exclude from the response. Reference parameters of sub-objects with dot notation (e.g., ‘_links’, ‘content’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_FILERetrieve detailed information about a specific file in the Mailchimp File Manager. Returns file metadata including the file’s unique ID, name, type, size, URLs for accessing the file (full-size and thumbnail), upload timestamp, and dimensions for image files. Use this action to get the public URL of a file for use in campaigns or to verify file details. Prerequisites: - You need a valid file_id. Use MAILCHIMP_LIST_STORED_FILES to get available file IDs. Returns: - File metadata including id, name, type, size, URLs, and dimensions (for images) - HATEOAS links for related operations (update, delete) Common use cases: - Get the public URL of an uploaded image for use in email campaigns - Verify file upload succeeded and get file details - Check file dimensions before using in templates

Input Parameters

array
A list of specific fields to include in the response. Use dot notation for nested fields (e.g., [‘id’, ‘name’, ‘full_size_url’]). If not specified, all fields are returned.
string
required
The unique numeric ID of the file in the File Manager. You can obtain file IDs by using the ‘List stored files’ action (MAILCHIMP_LIST_STORED_FILES) which returns all files with their IDs.
array
A list of fields to exclude from the response. Use dot notation for nested fields (e.g., [‘_links’] to exclude HATEOAS links). Cannot be used together with ‘fields’ parameter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_FOLDERGet information about a specific folder in the File Manager.

Input Parameters

array
A list of fields to return. Reference parameters of sub-objects with dot notation. Example: [‘id’, ‘name’, ‘file_count’].
string
required
The unique ID for the File Manager folder. Get folder IDs using the List Folders action.
array
A list of fields to exclude from the response. Reference parameters of sub-objects with dot notation. Example: [‘_links’] to exclude HATEOAS links.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_GROWTH_HISTORY_BY_MONTHRetrieves detailed growth statistics for a Mailchimp audience/list for a specific month. Returns subscriber metrics including existing members, new opt-ins, imports, unsubscribes, cleaned (bounced), pending, deleted, and transactional members. The month parameter must be in YYYY-MM format. Note: Returns 404 if no growth history data exists for the specified month - use ‘List growth history data’ action first to check available months.

Input Parameters

string
required
The month to retrieve growth history for in YYYY-MM format (e.g., ‘2024-01’ for January 2024). Returns 404 if no growth data exists for the specified month.
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
string
required
The unique ID for the Mailchimp audience/list (e.g., ‘abc123def4’). Use the ‘List all lists’ action to get available list IDs.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_INFORMATION_ABOUT_ALL_SURVEYS_FOR_A_LISTGet information about all available surveys for a specific list.

Input Parameters

string
required
The unique ID for the list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_INTEREST_CATEGORY_INFOGet detailed information about a specific interest category within a Mailchimp list/audience. Interest categories are groups of interests (preferences) that subscribers can select on signup forms. The type field determines how interests are displayed: checkboxes (multi-select), dropdown (single-select), radio (single-select), or hidden (internal tracking only).

Input Parameters

array
A list of fields to return. Available fields: id, list_id, title, display_order, type, _links. Use dot notation for sub-object fields (e.g., ‘_links.rel’).
string
required
The unique ID for the list/audience. Can be obtained from the List Lists action.
array
A list of fields to exclude from the response. Use dot notation for sub-object fields (e.g., ‘_links’ to exclude all links).
string
required
The unique ID for the interest category. Can be obtained from the List Interest Categories action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_INTEREST_IN_CATEGORYRetrieve details of a specific interest (group) within an interest category for a Mailchimp list.

Input Parameters

array
A list of fields to return. Available fields include: id, name, category_id, list_id, subscriber_count, display_order, _links. Use dot notation for nested fields.
string
required
The unique ID for the Mailchimp list (audience).
string
required
The unique ID for the specific interest (group) within the category.
array
A list of fields to exclude from the response. Use dot notation for nested fields (e.g., ‘_links’ to exclude HATEOAS links).
string
required
The unique ID for the interest category within the list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_LANDING_PAGE_CONTENTGet the HTML content for a specific Mailchimp landing page by its unique page ID.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
string
required
The unique identifier for the landing page. Can be obtained from the list_landing_pages action.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_LANDING_PAGE_INFORetrieve detailed information about a specific Mailchimp landing page including its name, title, status, tracking settings, and associated list.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
string
required
The unique identifier for the landing page. Can be obtained from the List Landing Pages action.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_LANDING_PAGE_REPORTGet analytics report for a specific landing page. Returns detailed statistics including total visits, clicks, and time-series data (daily and weekly). For e-commerce enabled pages, also includes revenue and order data. Use the list_landing_pages action to get available landing page IDs.

Input Parameters

array
A list of fields to return in the response. Available fields include: id, name, title, published_at, unpublished_at, status, list_id, visits, clicks, timeseries, ecommerce, web_id, list_name, signup_tags, _links. Use dot notation for nested fields (e.g., ‘timeseries.daily_stats’).
string
required
The unique identifier for the landing page. This is the ‘id’ field returned from the list_landing_pages action (e.g., ‘030001b4e1f0’).
array
A list of fields to exclude from the response. Useful for excluding large nested objects like ‘timeseries’ or ‘_links’ to reduce response size.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_LATEST_CHIMP_CHATTERReturn the Chimp Chatter for this account ordered by most recent.

Input Parameters

integer
The number of activity records to return. Default value is 10. Maximum value is 1000.
integer
Used for pagination, the number of records from a collection to skip. Default value is 0.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_LIST_INFOGet information and statistics for a specific Mailchimp audience (list).

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
string
required
The unique ID for the list.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
boolean
Return the total_contacts field in the stats response, which contains an approximate count of all contacts in any state.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_LISTS_INFOGet information about lists in the account, with pagination and optional filters. The default page contains up to 10 lists.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
string
Restrict results to lists that include a specific subscriber”s email address.
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string ("ASC" | "DESC")
Determines the order direction for sorted results.
string ("date_created")
Returns files sorted by the specified field.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
string
Restrict results to lists created after the set date. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
string
Restrict response to lists created before the set date. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
boolean
Restrict results to lists that contain an active, connected, undeleted ecommerce store.
boolean
Return the total_contacts field in the stats response, which contains an approximate count of all contacts in any state.
string
Restrict results to lists created after the last campaign send date. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
string
Restrict results to lists created before the last campaign send date. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_MEMBER_INFOGet information about a specific list member, including a currently subscribed, unsubscribed, or bounced member.

Input Parameters

string
Fields to return. Can be a list or comma-separated string. Use field names for top-level fields (e.g., ‘email_address’, ‘status’) or entire sub-objects (e.g., ‘merge_fields’). Use dot notation for specific nested fields (e.g., ‘merge_fields.FNAME’). Example: [‘email_address’, ‘status’, ‘merge_fields’] or ‘email_address,status,merge_fields’.
string
required
The unique ID for the list (audience). Can be found via the lists endpoint.
string
Fields to exclude. Can be a list or comma-separated string. Use field names for top-level fields or sub-objects (e.g., ‘_links’, ‘location’). Use dot notation for nested fields. Example: [‘_links’, ‘location’] or ‘_links,location’.
string
required
The MD5 hash of the lowercase version of the list member’s email address. This endpoint also accepts the member’s email address directly or their contact_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_MEMBER_NOTERetrieve a specific note attached to a list member in Mailchimp. Notes are internal annotations that can be added to subscriber records for tracking conversations, preferences, or other relevant information. This endpoint returns the full details of a single note by its ID.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation (e.g., ‘note’, ‘created_at’, ‘created_by’).
string
required
The unique ID for the Mailchimp list (audience). You can find this in your Mailchimp account under Audience > Settings > Audience name and defaults.
string
required
The unique numeric ID for the note. Can be obtained from the list_recent_member_notes endpoint.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation (e.g., ‘_links’).
string
required
The MD5 hash of the lowercase version of the list member’s email address. This endpoint also accepts the member’s email address directly or their contact_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_MERGE_FIELDRetrieve details about a specific merge field (custom audience field) for a Mailchimp list. Merge fields are custom data fields like First Name (FNAME), Last Name (LNAME), Address, etc. that store subscriber information. Use this to get configuration details including field type, display settings, and type-specific options.

Input Parameters

array
List of specific fields to return. Use dot notation for nested fields. Example: [‘merge_id’, ‘name’, ‘type’].
string
required
The unique ID for the Mailchimp audience (list). Example: ‘af9d6415f0’.
string
required
The numeric ID of the merge field to retrieve. Merge fields are custom fields like FNAME, LNAME, etc. Example: ‘1’ for FNAME.
array
List of fields to exclude from the response. Use dot notation for nested fields. Example: [‘_links’, ‘options’].

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_MESSAGEGet a specific message from a Mailchimp conversation. The conversation endpoint is outdated and replaced by Inbox; historical conversation data is accessible, but new replies and Inbox messages are not.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
string
required
The unique id for the conversation message.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
string
required
The unique id for the conversation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_OPENED_CAMPAIGN_SUBSCRIBERGet information about a specific subscriber who opened a campaign.

Input Parameters

array
A list of fields to return. Reference parameters of sub-objects with dot notation (e.g., [‘campaign_id’, ‘email_address’, ‘opens_count’]).
string
required
The unique id for the campaign. The campaign must have been sent to have open data.
array
A list of fields to exclude. Reference parameters of sub-objects with dot notation (e.g., [‘_links’, ‘merge_fields’]).
string
required
The MD5 hash of the lowercase version of the list member’s email address.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_ORDER_INFOGet information about a specific order.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
string
required
The id for the order in a store.
string
required
The store id.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_ORDER_LINE_ITEMGet information about a specific order line item.

Input Parameters

array
A list of fields to return. Reference parameters of sub-objects with dot notation (e.g., [‘id’, ‘product_id’, ‘price’]).
string
required
The unique identifier for the line item within the order.
string
required
The unique identifier for the order within the store.
string
required
The unique identifier for the e-commerce store.
array
A list of fields to exclude from the response. Reference parameters of sub-objects with dot notation (e.g., [‘_links’]).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_PRODUCT_IMAGE_INFORetrieve detailed information about a specific product image in a Mailchimp e-commerce store. Returns the image’s URL, associated variant IDs, and API links for related operations. Requires valid store_id, product_id, and image_id. Returns 404 if any ID is not found.

Input Parameters

array
List of fields to return in the response. Use dot notation for nested fields (e.g., [‘id’, ‘url’, ‘variant_ids’]). If not specified, all fields are returned.
string
required
The unique identifier for the product image to retrieve (e.g., ‘image_001’).
string
required
The unique identifier for the e-commerce store in Mailchimp (e.g., ‘my_store_001’).
string
required
The unique identifier for the product within the specified store (e.g., ‘product_123’).
array
List of fields to exclude from the response. Use dot notation for nested fields (e.g., [‘variant_ids’, ‘_links’]). Cannot be used together with ‘fields’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_PRODUCT_INFOGet information about a specific product.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
string
required
The store id.
string
required
The id for the product of a store.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_PRODUCT_VARIANT_INFORetrieve detailed information about a specific product variant from a Mailchimp e-commerce store. Returns variant details including title, SKU, price, inventory quantity, and URLs. Requires valid store_id, product_id, and variant_id. Use LIST_STORES, LIST_PRODUCT, and LIST_PRODUCT_VARIANTS to find the required identifiers.

Input Parameters

array
A list of fields to return. Use dot notation for sub-object fields (e.g., [‘id’, ‘title’, ‘price’]). If omitted, all fields are returned.
string
required
The unique identifier for the e-commerce store. Use LIST_STORES to find available store IDs.
string
required
The unique identifier for the product within the store. Use LIST_PRODUCT to find product IDs for a given store.
string
required
The unique identifier for the product variant. Use LIST_PRODUCT_VARIANTS to find variant IDs for a given product.
array
A list of fields to exclude from the response. Use dot notation for sub-object fields (e.g., [‘_links’]). Useful for reducing response size.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_PROMO_CODERetrieve detailed information about a specific promo code. Returns the promo code details including its code string, redemption URL, usage count, enabled status, and timestamps. Promo codes are associated with promo rules within e-commerce stores.

Input Parameters

array
A list of fields to return in the response. Use dot notation for sub-object fields (e.g., [‘id’, ‘code’, ‘enabled’]). If not specified, all fields are returned.
string
required
The unique identifier for the e-commerce store in Mailchimp.
string
required
The unique identifier for the specific promo code to retrieve.
string
required
The unique identifier for the promo rule that the promo code belongs to.
array
A list of fields to exclude from the response. Use dot notation for sub-object fields (e.g., [‘_links’] to exclude link information). Cannot be used with ‘fields’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_PROMO_RULEGet information about a specific promo rule.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
string
required
The store id.
string
required
The id for the promo rule of a store.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_SEGMENT_INFOGet information about a specific segment.

Input Parameters

array
A list of fields to return in the response. Use dot notation for sub-objects (e.g., ‘options.match’). Example: [‘id’, ‘name’, ‘member_count’].
string
required
The unique ID for the list (audience). Can be obtained from the List Lists (audiences) action.
string
required
The unique numeric ID for the segment. Can be obtained from the List Segments action.
array
A list of fields to exclude from the response. Use dot notation for sub-objects (e.g., ‘_links’). Example: [‘_links’, ‘options’].
boolean
Include cleaned (bounced/invalid) members in the member_count. Defaults to true.
boolean
Include unsubscribed members in the member_count. Defaults to false.
boolean
Include transactional members (non-subscribed contacts who received transactional emails) in the member_count. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_STORE_INFOGet information about a specific store.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
string
required
The store id.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_SUBSCRIBER_EMAIL_ACTIVITYGet a specific list member’s email activity in a sent campaign, including opens, clicks, bounces, and unsubscribes. The campaign must have been sent and the subscriber must have been a recipient for data to be available. Returns 404 if the campaign hasn’t been sent or if the subscriber wasn’t a recipient.

Input Parameters

string
Restrict results to email activity events that occur after a specific time. Uses ISO 8601 time format (e.g., ‘2015-10-21T15:41:36+00:00’).
array
A list of fields to return. Reference parameters of sub-objects with dot notation (e.g., [‘email_id’, ‘activity.action’]).
string
required
The unique id for the campaign. The campaign must have been sent to have email activity data.
array
A list of fields to exclude. Reference parameters of sub-objects with dot notation (e.g., [‘_links’]).
string
required
The MD5 hash of the lowercase version of the list member’s email address. The subscriber must have been a recipient of the campaign.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_SUBSCRIBER_REMOVED_FROM_WORKFLOWGet information about a specific subscriber who was removed from a classic automation workflow. Returns the subscriber’s email address and workflow details. The subscriber must have been previously removed using the remove_subscriber_from_workflow action. Returns 404 if the subscriber is not found in the removed subscribers list.

Input Parameters

string
required
The unique ID for the Automation workflow. Can be obtained from the list_automations action.
string
required
The MD5 hash of the lowercase version of the list member’s email address. For example, for ‘example@email.com’, compute md5(‘example@email.com’.lower()).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_SURVEYRetrieves detailed information about a specific survey associated with a Mailchimp audience (list). Returns survey metadata including its title, status, URL, timestamps, total response count, and the list of questions. Prerequisites: The survey must exist on the specified list. Surveys are created through the Mailchimp web interface, not via the API. Use ‘Get information about all surveys for a list’ to find available survey IDs for a given audience.

Input Parameters

string
required
The unique ID of the Mailchimp audience (list) containing the survey. You can get this from the ‘Get lists info’ action or from your Mailchimp dashboard under Audience > Settings > Audience name and defaults.
string
required
The unique ID of the survey to retrieve. You can get this from the ‘Get information about all surveys for a list’ action. Surveys must be created in the Mailchimp web interface before using this action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_SURVEY_QUESTION_REPORTRetrieves detailed reporting data for a specific question in a survey. Returns the question text, type, total response count, and for multiple choice questions, the breakdown of responses per option including counts. For rating questions, includes the average rating. Prerequisites: The survey and question must exist in your Mailchimp account. Surveys are created through the Mailchimp web interface, not via the API. Use ‘List survey reports’ to find survey IDs and ‘List survey question reports’ to find question IDs. Note: This action returns aggregated statistics for a single question. For detailed individual answers to a question, use ‘List answers for question’. For the overall survey report, use ‘Get survey report’.

Input Parameters

array
A list of fields to include in the response. Use dot notation for nested fields (e.g., [‘id’, ‘question’, ‘type’, ‘total_responses’]). If not specified, all fields are returned.
string
required
The unique ID of the survey containing the question. You can obtain survey IDs from the ‘List survey reports’ action which returns all surveys with reports in your account.
string
required
The unique ID of the survey question to retrieve the report for. You can obtain question IDs from the ‘List survey question reports’ action which returns all questions for a specific survey.
array
A list of fields to exclude from the response. Use dot notation for nested fields (e.g., [‘_links’]). Cannot be used together with the ‘fields’ parameter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_SURVEY_REPORTRetrieves detailed reporting data for a specific survey. Returns survey metadata including its title, status, public URL, creation/publication timestamps, total response count, and the associated audience information. Prerequisites: The survey must exist in your Mailchimp account. Surveys are created through the Mailchimp web interface, not via the API. Use ‘List survey reports’ to find available survey IDs for surveys that have report data. Note: This action returns report-level summary data. For detailed question-level reports, use ‘List survey question reports’. For individual response data, use ‘List survey responses’.

Input Parameters

array
A list of fields to include in the response. Use dot notation for nested fields (e.g., [‘id’, ‘title’, ‘total_responses’]). If not specified, all fields are returned.
string
required
The unique ID of the survey to retrieve report data for. You can obtain survey IDs from the ‘List survey reports’ action which returns all surveys with reports in your account.
array
A list of fields to exclude from the response. Use dot notation for nested fields (e.g., [‘_links’]). Cannot be used with ‘fields’ parameter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_SURVEY_RESPONSERetrieve a single survey response by its ID. Returns detailed information about the respondent’s answers to all questions in the survey. This endpoint is useful for examining individual responses in detail, including the respondent’s contact information and all their answers. Prerequisites: You must have an existing survey with at least one response. Surveys are created through the Mailchimp web interface and cannot be created via API.

Input Parameters

string
required
The unique identifier for the survey. You can get this ID from the ‘List survey reports’ action (/reporting/surveys) or from the ‘Get information about all surveys for a list’ action.
string
required
The unique identifier for a specific survey response. You can get this ID from the ‘List survey responses’ action (/reporting/surveys/{survey_id}/responses).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_TEMPLATE_FOLDERRetrieve information about a specific template folder in Mailchimp. Template folders are used to organize email templates. This action returns the folder’s name, unique ID, the count of templates it contains, and HATEOAS links for related operations (update, delete, list templates). Use this action when you need to: - Get details about a specific template folder - Check how many templates are in a folder - Retrieve links to related operations for the folder

Input Parameters

string
A comma-separated list of fields to return. Available fields: ‘id’, ‘name’, ‘count’, ‘_links’. Use dot notation for nested fields (e.g., ‘_links.rel’). If not specified, all fields are returned.
string
required
The unique ID of the template folder to retrieve. This ID can be obtained from the ‘list_template_folders’ action or from the response when creating a folder with ‘add_template_folder’.
string
A comma-separated list of fields to exclude from the response. Available fields: ‘id’, ‘name’, ‘count’, ‘_links’. Use dot notation for nested fields (e.g., ‘_links.rel’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_TEMPLATE_INFOGet information about a specific template.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation. Example: ‘id,name,type’ or ‘id,name,thumbnail’.
string
required
The unique id for the template. Can be obtained from the list_templates action.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation. Example: ‘_links’ to exclude HATEOAS links.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_UNSUBSCRIBED_MEMBERGet detailed information about a specific list member who unsubscribed from a campaign. This endpoint retrieves unsubscribe details for a member identified by their subscriber hash (MD5 of lowercase email) from a specific campaign’s report. The campaign must have been sent and the member must have unsubscribed from it. Use the List Unsubscribed Members endpoint first to find valid subscriber hashes for a campaign. Returns 404 if the subscriber hash is not found in the campaign’s unsubscribe list.

Input Parameters

array
A list of fields to return in the response. Use dot notation for sub-object fields (e.g., [‘email_address’, ‘merge_fields.FNAME’]). If not provided, all fields are returned.
string
required
The unique identifier for the campaign. This is the campaign from which the member unsubscribed. You can get campaign IDs from the List Campaigns endpoint.
array
A list of fields to exclude from the response. Use dot notation for sub-object fields (e.g., [‘_links’]). Cannot be used together with ‘fields’ parameter.
string
required
The MD5 hash of the lowercase version of the list member’s email address. For example, for ‘user@example.com’, use MD5(‘user@example.com’). You can get subscriber hashes from the List Unsubscribed Members endpoint.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_WEBHOOK_INFOGet information about a specific webhook for a Mailchimp list (audience). Returns the webhook’s URL, enabled events (subscribe, unsubscribe, profile, cleaned, upemail, campaign), and trigger sources (user, admin, api).

Input Parameters

string
required
The unique ID for the Mailchimp list (audience). Use MAILCHIMP_GET_LISTS_INFO to retrieve available list IDs.
string
required
The unique ID of the webhook. Use MAILCHIMP_LIST_WEBHOOKS to retrieve available webhook IDs for a list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_GET_WORKFLOW_EMAIL_INFOGet information about an individual classic automation workflow email.

Input Parameters

string
required
The unique ID for the Automation workflow. Can be obtained from the list_automations action.
string
required
The unique ID for the Automation workflow email. Can be obtained from the list_automated_emails action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_ABUSE_REPORTSGet a page of abuse reports for a specific list, with count and offset pagination.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The unique ID for the list.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_ACCOUNT_EXPORTSGet a list of account exports for a given account.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_ACCOUNT_ORDERSGet information about an account’s orders.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000.
string
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation. Example: ‘orders.id,orders.customer.email_address’.
integer
Used for pagination, this is the number of records from a collection to skip. Default value is 0.
string
Restrict results to orders with a specific campaign_id value.
string
Restrict results to orders made by a specific customer.
string
Restrict results to orders with a specific outreach_id value.
boolean
Restrict results to orders that have an outreach attached (e.g., email campaign or Facebook ad).
string
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation. Example: ‘orders._links’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_ANSWERS_FOR_QUESTIONRetrieves all answers submitted for a specific question in a Mailchimp survey. This endpoint is part of the Reporting API and provides detailed response data for survey analysis. Use this to analyze how respondents answered a particular question, including their contact information and submission timestamps. Prerequisites: - The survey must exist and have been published to collect responses - Surveys are created through the Mailchimp web interface, not via API - Use ‘List survey reports’ to find available survey IDs - Use ‘List survey question reports’ to find question IDs for a specific survey Returns a list of answers with respondent details and the answer values.

Input Parameters

array
A comma-separated list of fields to return. Use dot notation for nested fields (e.g., ‘answers.contact.email_address’). If not specified, all fields are returned.
string
required
The unique ID of the survey. You can get this from the ‘List survey reports’ action or from ‘Get information about all surveys for a list’. Surveys must be created in the Mailchimp web interface.
string
required
The unique ID of the survey question. You can get this from the ‘List survey question reports’ action by providing the survey_id.
array
A comma-separated list of fields to exclude from the response. Use dot notation for nested fields (e.g., ‘answers._links’). Cannot be used with ‘fields’ parameter.
string ("new" | "known" | "unknown")
Filter type for respondent familiarity with your brand.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_API_ROOT_RESOURCESGet Mailchimp account details and links to all available API resources. Returns account information including account ID, name, email, contact details, pricing plan, and subscriber count, along with navigation links to other API endpoints like lists, campaigns, automations, templates, and more.

Input Parameters

array
List of fields to include in the response. Use dot notation for nested fields (e.g., ‘contact.company’). Available fields include: account_id, account_name, email, first_name, last_name, username, role, member_since, pricing_plan_type, account_timezone, contact, total_subscribers, _links.
array
List of fields to exclude from the response. Use dot notation for nested fields (e.g., ‘contact.company’). Commonly excluded: _links (to reduce response size).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_AUTHORIZED_APPSGet a list of an account’s registered, connected applications.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_AUTOMATED_EMAILSGet a summary of the emails in a classic automation workflow.

Input Parameters

string
required
The unique id for the Automation workflow.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_AUTOMATED_EMAIL_SUBSCRIBERSGet information about a classic automation email queue.

Input Parameters

string
required
The unique id for the Automation workflow.
string
required
The unique id for the Automation workflow email.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_AUTOMATIONSGet a summary of an account’s classic automations.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string ("save" | "paused" | "sending")
Restrict the results to automations with the specified status.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
string
Restrict the response to automations started after this time. Uses the ISO 8601 time format: 2015-10-21T15:41:36+00:00.
string
Restrict the response to automations started before this time. Uses the ISO 8601 time format: 2015-10-21T15:41:36+00:00.
string
Restrict the response to automations created after this time. Uses the ISO 8601 time format: 2015-10-21T15:41:36+00:00.
string
Restrict the response to automations created before this time. Uses the ISO 8601 time format: 2015-10-21T15:41:36+00:00.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_BATCH_REQUESTSGet a summary of batch requests that have been made.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_BATCH_WEBHOOKSList configured batch webhooks with count and offset pagination.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_CAMPAIGN_CLICK_DETAILSList tracked links and click metrics for a sent Mailchimp campaign.

Input Parameters

integer
The number of records to return, from 1 through 1000.
array
Fields to return, using dot notation for nested fields.
integer
The number of records to skip before returning this page.
string ("ASC" | "DESC")
The direction used to sort results.
string ("total_clicks" | "unique_clicks")
The click metric used to sort links.
string
required
The unique id for the sent campaign.
boolean
Whether to exclude automated bot clicks from returned metrics.
array
Fields to exclude, using dot notation for nested fields.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_CAMPAIGN_FEEDBACKGet team feedback while you’re working together on a Mailchimp campaign.

Input Parameters

array
A list of fields to include in the response. Use dot notation for nested fields (e.g., ‘feedback.message’, ‘feedback.feedback_id’, ‘total_items’). If not specified, all fields are returned.
string
required
The unique identifier for the campaign. This is a 10-character alphanumeric string (e.g., ‘cdf16ea7a1’). You can obtain campaign IDs from the list campaigns action.
array
A list of fields to exclude from the response. Use dot notation for nested fields (e.g., ‘feedback._links’, ‘_links’). Useful for reducing response size.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_CAMPAIGN_FOLDERSGet all folders used to organize campaigns.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_CAMPAIGN_OPEN_DETAILSGet detailed information about any campaign emails that were opened by a list member.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
string
Restrict results to campaign open events that occur after a specific time. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string ("ASC" | "DESC")
Determines the order direction for sorted results.
string ("opens_count")
Returns open reports sorted by the specified field.
string
required
The unique id for the campaign.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_CAMPAIGN_PRODUCT_ACTIVITYGet breakdown of product activity for a campaign

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string ("title" | "total_revenue" | "total_purchased")
Returns products sorted by the specified field (title, total_revenue, or total_purchased).
string
required
The unique ID for a sent campaign. The campaign must have e-commerce tracking enabled and associated orders to return product activity data.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_CAMPAIGN_RECIPIENTSGet information about campaign recipients.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The unique id for the campaign.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_CAMPAIGN_REPORTSRetrieve analytics reports for sent email campaigns. Returns performance metrics including opens, clicks, bounces, unsubscribes, and e-commerce data for campaigns that have been sent.

Input Parameters

string ("regular" | "plaintext" | "absplit" | "rss" | "variate")
Filter by campaign type. Options: ‘regular’ (standard email), ‘plaintext’ (text-only), ‘absplit’ (A/B test), ‘rss’ (RSS-driven), ‘variate’ (multivariate test).
integer
Number of campaign reports to return per page. Default: 10, Maximum: 1000.
array
List of fields to include in response (e.g., [‘reports.id’, ‘reports.campaign_title’, ‘total_items’]). Use dot notation for nested fields.
integer
Number of records to skip for pagination. Default: 0. Use with ‘count’ to paginate through results.
array
List of fields to exclude from response (e.g., [‘_links’]). Use dot notation for nested fields.
string
Restrict the response to campaigns sent after the set time. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
string
Restrict the response to campaigns sent before the set time. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_CAMPAIGNSGet all campaigns in an account.

Input Parameters

string ("regular" | "plaintext" | "absplit" | "rss" | "variate")
The campaign type.
integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string ("save" | "paused" | "schedule" | "sending" | "sent")
The status of the campaign.
string
The unique id for the list.
string ("ASC" | "DESC")
Determines the order direction for sorted results.
string
The unique folder id.
string
Retrieve campaigns sent to a particular list member. Member ID is The MD5 hash of the lowercase version of the list member’s email address.
string ("create_time" | "send_time")
Returns files sorted by the specified field.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
string
Restrict the response to campaigns sent after the set time. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
string
Restrict the response to campaigns sent before the set time. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
string
Restrict the response to campaigns created after the set time. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
string
Restrict the response to campaigns created before the set time. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
boolean
Return the resend_shortcut_eligibility field in the response, which tells you if the campaign is eligible for the various Campaign Resend Shortcuts offered.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_CART_LINE_ITEMSRetrieve a page of line items in a specified e-commerce store’s shopping cart, including product and variant details, quantity, and price. Use count and offset to paginate.

Input Parameters

integer
The number of line item records to return. Default value is 10. Maximum value is 1000.
array
A list of fields to return in the response. Use dot notation to reference sub-object fields (e.g., ‘lines.id’, ‘lines.product_id’, ‘total_items’).
integer
The number of records to skip for pagination. Default value is 0. Use with ‘count’ to paginate through large result sets.
string
required
The unique identifier of the cart whose line items you want to retrieve.
string
required
The unique identifier of the e-commerce store containing the cart.
array
A list of fields to exclude from the response. Use dot notation to reference sub-object fields (e.g., ‘_links’, ‘lines._links’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_CARTSGet information about a store’s carts.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The unique identifier for the e-commerce store. Use the List Stores action to retrieve available store IDs.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_CHILD_CAMPAIGN_REPORTSGet a list of child campaign reports for a specific parent campaign. This endpoint returns reports for child campaigns that are part of A/B split test (variate) or RSS campaigns. For regular campaigns, this will return an empty reports array with total_items=0 since they do not have child campaigns.

Input Parameters

array
A list of fields to return. Use dot notation for sub-object fields (e.g., ‘reports.id’, ‘reports.campaign_title’, ‘reports.opens.opens_total’).
string
required
The unique identifier for the parent campaign (10-character alphanumeric string).
array
A list of fields to exclude from the response. Use dot notation for sub-object fields (e.g., ‘_links’, ‘reports._links’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_CONNECTED_SITESGet a page of connected sites in an account. Use count and offset to paginate.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_CONVERSATIONSList of conversations for an account is available via an endpoint, but it’s deprecated in favor of Inbox. The endpoint excludes new Inbox data including campaign replies and messages. Past conversations remain accessible.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
The unique id for the list.
string
The unique id for the campaign.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
string ("true" | "false")
Whether the conversation has any unread messages.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_CUSTOMERSGet information about a store’s customers.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The unique identifier for the e-commerce store. This is the custom ID you defined when creating the store via the Mailchimp API.
string
Restrict the response to customers with the email address.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_DOMAIN_PERFORMANCE_STATSGet statistics for the top-performing email domains in a campaign.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
string
required
The unique id for the campaign.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_EEP_URL_ACTIVITYGet EepURL click activity for a campaign. EepURL is Mailchimp’s shareable campaign archive link used for social media sharing. Returns referrer information including IP addresses/domains that clicked the link, click counts, and timestamps.

Input Parameters

array
A list of fields to return in the response. Use dot notation for sub-object fields (e.g., ‘referrers.clicks’). Available fields: referrers, eepurl, campaign_id, total_items, _links.
string
required
The unique identifier for the campaign. Get this from the LIST_CAMPAIGNS action.
array
A list of fields to exclude from the response. Use dot notation for sub-object fields (e.g., ‘_links’). Cannot be used together with ‘fields’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_EMAIL_ACTIVITYGet a list of member’s subscriber activity in a specific campaign.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
string
Restrict results to email activity events that occur after a specific time. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The unique id for the campaign.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_FACEBOOK_ADSGet list of Facebook ads.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string ("ASC" | "DESC")
Determines the order direction for sorted results.
string ("created_at" | "updated_at" | "end_time")
Returns files sorted by the specified field.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_FACEBOOK_ADS_REPORTSGet reports of Facebook ads.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string ("ASC" | "DESC")
Determines the order direction for sorted results.
string ("created_at" | "updated_at" | "end_time")
Returns files sorted by the specified field.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_FACEBOOK_ECOMMERCE_REPORTGet breakdown of product activity for a Facebook ad outreach. Returns a paginated list of products with ecommerce activity metrics attributed to a specific Facebook ad campaign. Includes revenue, purchase counts, and recommendation data for each product. Note: Requires a valid outreach_id which can be obtained from the list_facebook_ads or list_facebook_ads_reports endpoints. The Facebook ad must have ecommerce tracking enabled with a connected store.

Input Parameters

integer
The number of product records to return. Default value is 10. Maximum value is 1000.
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation (e.g., ‘products.title’, ‘products.total_revenue’). If not specified, all fields are returned.
integer
Used for pagination - the number of records from the collection to skip. Default value is 0.
string ("title" | "total_revenue" | "total_purchased")
Sort field options for ecommerce product activity.
string
required
The unique identifier of the Facebook ad outreach to retrieve product activity for. This ID can be obtained from the list_facebook_ads or list_facebook_ads_reports endpoints.
array
A comma-separated list of fields to exclude from the response. Reference parameters of sub-objects with dot notation (e.g., ‘_links’, ‘products._links’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_FOLDERSList folders in the Mailchimp File Manager, with pagination and optional creator and creation-date filters.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
The Mailchimp account user who created the File Manager file.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
string
Restrict the response to files created after the set date. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
string
Restrict the response to files created before the set date. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_GROWTH_HISTORY_DATAGet a month-by-month summary of a specific list’s growth activity.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The unique ID for the list.
string ("ASC" | "DESC")
Determines the order direction for sorted results.
string ("month")
Returns files sorted by the specified field.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_INTEREST_CATEGORIESGet information about a list’s interest categories.

Input Parameters

string
Restrict results a type of interest group
integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The unique ID for the list.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_INTERESTS_IN_CATEGORYGet a list of this category’s interests.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The unique ID for the list.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
string
required
The unique ID for the interest category.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_LANDING_PAGESList landing pages in the Mailchimp account. The request defaults to 10 results and supports count and sorting; it does not provide an offset for retrieving later pages.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
string ("ASC" | "DESC")
Determines the order direction for sorted results.
string ("created_at" | "updated_at")
Returns files sorted by the specified field.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_LANDING_PAGES_REPORTSGet performance reports for landing pages. Returns analytics data including visits, unique visits, clicks, subscribes, and conversion rates for published landing pages. Only landing pages that have been published will appear in reports.

Input Parameters

integer
The number of records to return. Default is 10. Maximum is 1000.
array
List of fields to return in the response. Use dot notation for nested fields (e.g., ‘landing_pages.id’, ‘landing_pages.name’, ‘total_items’).
integer
The number of records to skip for pagination. Default is 0.
array
List of fields to exclude from the response. Use dot notation for nested fields (e.g., ‘_links’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_LOCATIONSGet the locations (countries) that the list’s subscribers have been tagged to based on geocoding their IP address.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
string
required
The unique ID for the list.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_MEMBER_EVENTSGet events for a contact.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The unique ID for the list.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
string
required
The MD5 hash of the lowercase version of the list member”s email address. This endpoint also accepts a list member”s email address or contact_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_MEMBER_GOAL_EVENTSGet the last 50 Goal events for a member on a specific list.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
string
required
The unique ID for the list.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
string
required
The MD5 hash of the lowercase version of the list member”s email address. This endpoint also accepts a list member”s email address or contact_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_MEMBERS_INFOGet information about members in a specific Mailchimp list.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string ("subscribed" | "unsubscribed" | "cleaned" | "pending" | "transactional" | "archived")
The subscriber”s status.
string
required
The unique ID for the list.
string ("ASC" | "DESC")
Determines the order direction for sorted results.
boolean
A filter to return only the list”s VIP members. Passing true will restrict results to VIP list members, passing false will return all list members.
string
The email type.
string ("timestamp_opt" | "timestamp_signup" | "last_changed")
Returns files sorted by the specified field.
string
Used to filter list members by interests. Must be accompanied by interest_category_id and interest_match. The value must be a comma separated list of interest ids present for any supplied interest categories.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
string ("any" | "all" | "none")
Used to filter list members by interests. Must be accompanied by interest_category_id and interest_ids. “any” will match a member with any of the interest supplied, “all” will only match members with every interest supplied, and “none” will match members without any of the interest supplied.
string
A unique identifier for the email address across all Mailchimp lists.
string
Restrict results to subscribers whose information changed after the set timeframe. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
string
Filter subscribers by those unsubscribed since a specific date. Using any status other than unsubscribed with this filter will result in an error.
string
Restrict results to subscribers whose information changed before the set timeframe. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
boolean
Filter subscribers by those subscribed/unsubscribed/pending/cleaned since last email campaign send. Member status is required to use this filter.
string
Restrict results to subscribers who opted-in after the set timeframe. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
string
Restrict results to subscribers who opted-in before the set timeframe. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
string
The unique id for the interest category.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_MEMBERS_IN_SEGMENTGet information about members in a saved segment.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The unique ID for the list.
string
required
The unique id for the segment.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
boolean
Include cleaned members in response
boolean
Include unsubscribed members in response
boolean
Include transactional members in response

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_MEMBER_TAGSGet the tags on a list member.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The unique ID for the list.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
string
required
The MD5 hash of the lowercase version of the list member”s email address. This endpoint also accepts a list member”s email address or contact_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_MERGE_FIELDSList merge fields for an audience, with pagination and optional type and required-status filters.

Input Parameters

string
The merge field type.
integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The unique ID for the list.
boolean
Whether it”s a required merge field.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_MESSAGESList all messages from a specific conversation in Mailchimp. NOTE: The Conversations API is deprecated and replaced by Inbox. This endpoint only returns historical conversation data. New campaign replies and Inbox messages are NOT available through this endpoint. Use ‘List Conversations’ first to obtain valid conversation IDs.

Input Parameters

array
A comma-separated list of fields to return. Reference nested fields with dot notation (e.g., ‘conversation_messages.id,conversation_messages.subject’).
string ("true" | "false")
Filter messages by read status. Set to ‘true’ for read messages only, or ‘false’ for unread messages only.
array
A comma-separated list of fields to exclude from the response. Reference nested fields with dot notation (e.g., ‘_links’).
string
required
The unique ID of the conversation to retrieve messages from. Obtain this from the List Conversations endpoint.
string
Filter messages created after this time. Uses ISO 8601 format (e.g., ‘2024-10-21T15:41:36+00:00’).
string
Filter messages created before this time. Uses ISO 8601 format (e.g., ‘2024-10-21T15:41:36+00:00’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_ORDER_LINE_ITEMSGet information about an order’s line items.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A list of fields to return. Use dot notation for sub-object properties (e.g., [‘lines.id’, ‘lines.price’, ‘lines.quantity’]). When specified, only these fields are included in the response.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The unique identifier for the order within the store.
string
required
The unique identifier for the e-commerce store.
array
A list of fields to exclude from the response. Use dot notation for sub-object properties (e.g., [‘lines._links’]). When specified, these fields are omitted from the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_ORDERSGet information about a store’s orders.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The store id.
string
Restrict results to orders with a specific campaign_id value.
string
Restrict results to orders made by a specific customer.
string
Restrict results to orders with a specific outreach_id value.
boolean
Restrict results to orders that have an outreach attached. For example, an email campaign or Facebook ad.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_PRODUCTGet information about a store’s products.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The store id.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_PRODUCT_IMAGESGet information about a product’s images.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The store id.
string
required
The id for the product of a store.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_PRODUCT_VARIANTSList all variants for a specific product in a Mailchimp e-commerce store. Returns a paginated list of product variants including details like title, SKU, price, inventory quantity, and URLs. Use ‘count’ and ‘offset’ parameters to paginate through large variant lists. Requires valid store_id and product_id. Use LIST_STORES and LIST_PRODUCT to find the required identifiers.

Input Parameters

integer
The number of variant records to return. Default is 10. Maximum is 1000.
array
A list of fields to return. Use dot notation for sub-object fields (e.g., [‘variants.id’, ‘variants.title’, ‘total_items’]). If omitted, all fields are returned.
integer
The number of records to skip for pagination. Default is 0. Use with ‘count’ to paginate through large variant lists.
string
required
The unique identifier for the e-commerce store. Use LIST_STORES to find available store IDs.
string
required
The unique identifier for the product within the store. Use LIST_PRODUCT to find product IDs for a given store.
array
A list of fields to exclude from the response. Use dot notation for sub-object fields (e.g., [‘variants._links’]). Useful for reducing response size.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_PROMO_CODESGet information about promo codes for a specific promo rule in a store.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The store id.
string
required
The id for the promo rule of a store.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_PROMO_RULESGet information about a store’s promo rules.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The store id.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_RECENT_ACTIVITYGet up to the previous 180 days of daily detailed aggregated activity stats for a list, not including Automation activity.

Input Parameters

integer
The number of activity records to return. Default value is 10. Maximum value is 1000.
array
A list of fields to return. Reference parameters of sub-objects with dot notation (e.g., [‘activity.day’, ‘activity.subs’, ‘total_items’]).
integer
Used for pagination, this is the number of records from a collection to skip. Default value is 0.
string
required
The unique ID for the Mailchimp audience/list (e.g., ‘af9d6415f0’).
array
A list of fields to exclude. Reference parameters of sub-objects with dot notation (e.g., [‘_links’]).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_RECENT_MEMBER_NOTESGet recent notes for a specific list member.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
List of fields to return. Use dot notation for nested fields (e.g., ‘notes.id’, ‘notes.note’, ‘notes.created_at’). If not specified, all fields are returned.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The unique ID for the list.
string ("ASC" | "DESC")
Sort direction. ‘ASC’ for ascending (oldest first) or ‘DESC’ for descending (newest first).
string ("created_at" | "updated_at" | "note_id")
Field to sort notes by. Options: ‘created_at’, ‘updated_at’, or ‘note_id’.
array
List of fields to exclude from the response. Use dot notation for nested fields (e.g., ‘notes._links’).
string
required
The MD5 hash of the lowercase version of the list member’s email address. This value is also available as the ‘id’ field when listing members.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_SEGMENTSGet information about segments for a specific Mailchimp list. Results are paginated and can be filtered by segment type and creation or update time.

Input Parameters

string
Limit results based on segment type.
integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The unique ID for the list.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
boolean
Include cleaned members in response
string
Restrict results to segments created after the set time. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
string
Restrict results to segments update after the set time. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
string
Restrict results to segments created before the set time. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
string
Restrict results to segments update before the set time. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
boolean
Include unsubscribed members in response
boolean
Include transactional members in response

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_SENDING_DOMAINSGet all of the sending domains on the account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_SIGNUP_FORMSGet signup forms for a specific list.

Input Parameters

string
required
The unique ID for the list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_STORED_FILESGet a list of available images and files stored in the File Manager for the account.

Input Parameters

string
The file type for the File Manager file.
integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string ("ASC" | "DESC")
Determines the order direction for sorted results.
string
The Mailchimp account user who created the File Manager file.
string ("added_date" | "name" | "size")
Returns files sorted by the specified field.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
string
Restrict the response to files created after the set date. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
string
Restrict the response to files created before the set date. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_STORESGet a page of information about stores in the account, with count and offset pagination.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_SUBSCRIBERS_REMOVED_FROM_WORKFLOWGet information about subscribers who were removed from a classic automation workflow.

Input Parameters

string
required
The unique id for the Automation workflow.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_SURVEY_QUESTION_REPORTSGet reports for all questions in a specific survey. Returns detailed reporting data for each question in the survey, including response counts, answer distributions for choice questions, and average ratings for range questions. This action is useful for analyzing survey results and understanding how respondents answered each question. Prerequisites: - A survey must exist in your Mailchimp account (surveys are created in the web interface) - Use ‘List survey reports’ or ‘Get information about all surveys for a list’ to find survey IDs Returns 404 error if the survey_id does not exist.

Input Parameters

string
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation. Example: ‘questions.id,questions.text,total_items’.
string
required
The unique ID of the survey to get question reports for. You can get this from the ‘List survey reports’ action or the ‘Get information about all surveys for a list’ action. Surveys are created in the Mailchimp web interface.
string
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation. Example: ‘_links’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_SURVEY_REPORTSGet reports for surveys.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_SURVEY_RESPONSESList responses submitted to a survey, with pagination and optional filters. Response records can include respondent identifiers, email address, and submission timestamp.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000.
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation (e.g., ‘responses.response_id,responses.submitted_at’). If not specified, all fields are returned.
integer
Used for pagination, this is the number of records from a collection to skip. Default value is 0.
string
required
The unique identifier for the survey. You can get this ID from the ‘List survey reports’ action (/reporting/surveys) or from the ‘Get information about all surveys for a list’ action. Surveys must be created through the Mailchimp web interface.
string
Filter responses to only those that chose a specific answer option. Provide the answer option ID. Works in conjunction with answered_question.
array
A comma-separated list of fields to exclude from the response. Reference parameters of sub-objects with dot notation (e.g., ‘responses._links’).
integer
Filter responses to only those that answered a specific question. Provide the numeric question ID from the survey.
string ("new" | "known" | "unknown")
Filter type for survey respondent familiarity.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_TEMPLATE_FOLDERSRetrieve all template folders from the Mailchimp account. Template folders are used to organize email templates. This action returns a paginated list of all folders with their IDs, names, and template counts. Use the count and offset parameters to paginate through large result sets.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A list of fields to return. Reference sub-object fields with dot notation (e.g., ‘folders.id’, ‘folders.name’). If not specified, all fields are returned.
integer
The number of records to skip from the beginning of the result set. Used for pagination. Default value is 0.
array
A list of fields to exclude from the response. Reference sub-object fields with dot notation (e.g., ‘folders._links’). Cannot be used with ‘fields’ parameter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_TEMPLATESGet a list of an account’s available templates.

Input Parameters

string
Limit results based on template type.
integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
Limit results based on category.
string ("ASC" | "DESC")
Determines the order direction for sorted results.
string
The unique folder id.
string
The Mailchimp account user who created the template.
string ("date_created" | "date_edited" | "name")
Returns user templates sorted by the specified field.
string ("html" | "template" | "multichannel")
Limit results based on how the template”s content is put together. Only templates of type user can be filtered by content_type. If you want to retrieve saved templates created with the legacy email editor, then filter content_type to template. If you”d rather pull your saved templates for the new editor, filter to multichannel. For code your own templates, filter to html.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
string
Restrict the response to templates created after the set date. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
string
Restrict the response to templates created before the set date. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_TOP_EMAIL_CLIENTSGet the top email clients used by subscribers in a Mailchimp list/audience. Returns statistics about the email clients (e.g., Gmail, Apple Mail, Outlook) used by subscribers, including the number of members using each client and the percentage of the total list. This data is collected via open tracking and relies on image loading, so contacts who disable images will not be tracked.

Input Parameters

array
A list of fields to include in the response. Available fields: ‘clients’, ‘list_id’, ‘total_items’, ‘_links’. Use dot notation for sub-object fields (e.g., ‘clients.client’, ‘clients.members’).
string
required
The unique ID for the Mailchimp audience/list. This is a 10-character alphanumeric string.
array
A list of fields to exclude from the response. Common usage: exclude ‘_links’ to reduce response size. Use dot notation for sub-object fields.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_TOP_OPEN_ACTIVITIESGet top open locations for a specific campaign. Returns geographic data about where subscribers opened a campaign email, based on geocoding their IP addresses. Results include country codes, regions, and open counts for each location.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A list of fields to return. Reference parameters of sub-objects with dot notation (e.g., [‘locations’, ‘campaign_id’, ‘total_items’]).
integer
Used for pagination, this is the number of records from a collection to skip. Default value is 0.
string
required
The unique id for the campaign.
array
A list of fields to exclude. Reference parameters of sub-objects with dot notation (e.g., [‘_links’]).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_UNSUBSCRIBED_MEMBERSGet information about members who have unsubscribed from a specific campaign.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The unique id for the campaign.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_LIST_WEBHOOKSGet information about all webhooks for a specific list.

Input Parameters

string
required
The unique ID for the list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_PAUSE_AUTOMATED_EMAILPause a specific automated email within a classic automation workflow. This action pauses the sending of a specific automated email. The email must currently be in ‘sending’ (active) status. Use the start_automated_email action to resume a paused email. Prerequisites: - The automation workflow must exist - The email within the workflow must be in ‘sending’ status (not ‘save’ or ‘paused’) Common errors: - 400 Bad Request: Email is already paused or in draft state - 404 Not Found: Invalid workflow_id or workflow_email_id

Input Parameters

string
required
The unique id for the Automation workflow. Obtain this from list_automations action.
string
required
The unique id for the Automation workflow email. Obtain this from list_automated_emails action using the workflow_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_PAUSE_AUTOMATION_EMAILSPause all emails in a specific classic automation workflow. This action pauses all emails in a classic automation workflow. The automation must be in ‘sending’ status to be paused. If the automation is already paused or in draft/save status, the API will return an error. Use cases: - Temporarily stop an automation workflow from sending emails - Pause automation for maintenance or content updates - Stop emails during a campaign review period Note: To resume a paused automation, use the start_automation_emails action.

Input Parameters

string
required
The unique identifier for the Automation workflow. You can obtain this ID from the list_automations action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_PAUSE_RSS_CAMPAIGNPause an RSS-Driven campaign that is currently sending. This action pauses an active RSS campaign, stopping it from sending new emails based on its schedule until it is resumed. Only campaigns of type ‘rss’ that are currently in ‘sending’ status can be paused. Prerequisites: - The campaign must be of type ‘rss’ (not ‘regular’, ‘plaintext’, etc.) - The campaign must be in ‘sending’ status (actively running according to schedule) - Campaigns in ‘save’, ‘paused’, or ‘sent’ status cannot be paused Use RESUME_RSS_CAMPAIGN to resume a paused RSS campaign. Use LIST_CAMPAIGNS with type=‘rss’ to find RSS campaigns.

Input Parameters

string
required
The unique id for the RSS-driven campaign to pause. The campaign must be of type ‘rss’ and currently in ‘sending’ status. Use LIST_CAMPAIGNS with type=‘rss’ and status=‘sending’ to find eligible campaigns.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_PINGA health check for the API that won’t return any account-specific information.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_PUBLISH_A_SURVEYPublishes a survey that is in draft, unpublished, or has been previously published and edited. Once published, the survey becomes accessible via its public URL and can collect responses from your audience. Prerequisites: The survey must exist on the specified list and must be created through the Mailchimp web interface (surveys cannot be created via the API). The survey must be in ‘draft’ or ‘unpublished’ status. Use ‘Get information about all surveys for a list’ to find available surveys and their current status.

Input Parameters

string
required
The unique ID of the Mailchimp audience (list) containing the survey. You can get this from the ‘Get lists info’ action or from your Mailchimp dashboard under Audience > Settings > Audience name and defaults.
string
required
The unique ID of the survey to publish. You can get this from the ‘Get information about all surveys for a list’ action. The survey must be in ‘draft’ or ‘unpublished’ status. Surveys must be created in the Mailchimp web interface before using this action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_PUBLISH_LANDING_PAGEPublish a Mailchimp landing page to make it live and accessible to visitors. Publishes a landing page that is currently in ‘draft’, ‘unpublished’, or has been previously published and edited. Once published, the landing page will be accessible via its public URL. Requirements: - The landing page must exist and be in a publishable state (draft or unpublished) - The Mailchimp account must have sending permissions enabled - The landing page should have valid content configured Note: Returns HTTP 204 No Content on successful publish with an empty response body.

Input Parameters

string
required
The unique identifier for the landing page to publish. This ID can be obtained from the list landing pages endpoint or when creating a new landing page. Format: 12-character alphanumeric string (e.g., ‘030001b4e1f0’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_REMOVE_LIST_MEMBER_FROM_SEGMENTRemove a member from a static segment in a Mailchimp list/audience. This action removes a list member from a specified static segment. The member remains in the list - they are only removed from the segment membership. Important notes: - Only works with static segments (type=‘static’), not dynamic/saved segments - Returns HTTP 204 No Content on success - Returns HTTP 404 if the member is not found in the segment - This is an idempotent operation

Input Parameters

string
required
The unique ID for the Mailchimp list/audience. You can get this from the get_lists_info action.
string
required
The unique ID for the static segment. This action only works with static segments (not dynamic/saved segments). You can get this from the list_segments action.
string
required
The MD5 hash of the lowercase version of the list member’s email address. For example, for ‘user@example.com’, compute MD5 of ‘user@example.com’. You can also use the member ‘id’ field returned by list_members_info or add_member_to_segment actions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_REMOVE_SUBSCRIBER_FROM_WORKFLOWRemove a subscriber from a classic automation workflow at any point in the sequence. IMPORTANT: Once removed, the subscriber can NEVER be re-added to the same workflow. This action is irreversible. Prerequisites: - The automation must be in ‘sending’ or ‘paused’ status (not ‘save’ or ‘archived’) - The automation must have a list/audience associated with it - The email address must belong to a subscriber on that list Use MAILCHIMP_LIST_AUTOMATIONS to find workflows and check their status. Use MAILCHIMP_LIST_MEMBERS_INFO to verify subscriber email addresses.

Input Parameters

string
required
The unique ID for the classic automation workflow (e.g., ‘abc123def4’). Use MAILCHIMP_LIST_AUTOMATIONS to retrieve available workflow IDs. Note: The automation must be in ‘sending’ or ‘paused’ status to remove subscribers.
string
required
The email address of the list member to remove from the workflow (e.g., ‘user@example.com’). The subscriber must be on the list associated with this automation. Once removed, they cannot be re-added to this workflow.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_REPLICATE_CAMPAIGNReplicate a campaign in saved or send status.

Input Parameters

string
required
The unique id for the campaign.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_RESEND_CAMPAIGNResend a previously sent campaign to specific subscriber segments. This creates a replica of the original campaign and sends it to common segments such as those who didn’t open the original campaign, didn’t click any links, or new subscribers added since the campaign was sent. IMPORTANT: The original campaign must: - Have been previously sent (status=‘sent’) - Have tracking enabled (opens/clicks tracking) - Be eligible for resending (check the ‘resendable’ field on the campaign)

Input Parameters

string
required
The unique id for the campaign to resend. The campaign must have been previously sent and have tracking enabled. You can verify a campaign is eligible by checking its ‘resendable’ field.
string ("to_non_openers" | "to_new_subscribers" | "to_non_clickers")
Which campaign resend shortcut to use. Options: ‘to_non_openers’ (resend to subscribers who didn’t open), ‘to_new_subscribers’ (send to subscribers added since the campaign was sent), ‘to_non_clickers’ (resend to subscribers who didn’t click). If not specified, defaults to ‘to_non_openers’ on the server side.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_RESUME_RSS_CAMPAIGNResume an RSS-Driven campaign that was previously paused. This action restarts the RSS feed delivery schedule for a paused RSS campaign. The campaign will continue checking the RSS feed and sending emails according to its configured schedule. Prerequisites: - Campaign must be of type ‘rss’ - Campaign must be in ‘paused’ status (was previously running and then paused) - Use PAUSE_RSS_CAMPAIGN to pause a running RSS campaign first - Use LIST_CAMPAIGNS with type=‘rss’ and status=‘paused’ to find eligible campaigns On success, returns HTTP 204 No Content. The campaign status will change from ‘paused’ back to ‘sending’.

Input Parameters

string
required
The unique id for the RSS-driven campaign to resume. The campaign must be of type ‘rss’ and in ‘paused’ status.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_RETRIEVE_CAMPAIGN_ABUSE_COMPLAINTSGet a list of abuse complaints for a specific campaign.

Input Parameters

array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
string
required
The unique id for the campaign.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_RETRIEVE_FOLDER_CONTENTSGet a list of available images and files stored in this folder.

Input Parameters

string
The file type for the File Manager file.
integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string ("ASC" | "DESC")
Determines the order direction for sorted results.
string
required
The unique id for the File Manager folder.
string
The Mailchimp account user who created the File Manager file.
string ("added_date" | "name" | "size")
Returns files sorted by the specified field.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.
string
Restrict the response to files created after the set date. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
string
Restrict the response to files created before the set date. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_SCHEDULE_CAMPAIGNSchedule a campaign for delivery at a specific date and time. Important notes: - The campaign must be in ‘save’ (draft) status and pass all send checklist items - Schedule time must be in the future and on the quarter-hour (:00, :15, :30, :45) - If using Multivariate Campaigns to test send times or RSS Campaigns, use the send action instead - Timewarp and Batch Delivery cannot be used together - Requires a paid Mailchimp plan to schedule campaigns (free plans cannot schedule)

Input Parameters

boolean
Choose whether the campaign should use Timewarp when sending. Campaigns scheduled with Timewarp are localized based on the recipients’ time zones. For example, a Timewarp campaign with a schedule_time of 13:00 will be sent to each recipient at 1:00pm in their local time. Cannot be set to true for campaigns using Batch Delivery.
string
required
The unique ID for the campaign to schedule (e.g., ‘c16afdffd0’).
string
required
The UTC date and time to schedule the campaign for delivery in ISO 8601 format (e.g., ‘2026-01-26T12:00:00+00:00’). Campaigns may only be scheduled to send on the quarter-hour (:00, :15, :30, :45). Must be at least 15 minutes in the future.
integer
The number of batches to divide the campaign send into when using Batch Delivery. Required if batch_delivery_batch_delay is provided. Cannot be used with Timewarp.
integer
The delay, in minutes, between batches when using Batch Delivery. Required if batch_delivery_batch_count is provided. Enables staggered sending to reduce server load.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_SEARCH_CAMPAIGNSSearch all campaigns for the specified query terms. This action searches across campaign titles, subject lines, and content to find campaigns matching the provided query. Returns detailed campaign information including settings, tracking configuration, recipients, and status. Use the ‘fields’ parameter to limit response data or ‘exclude_fields’ to remove unnecessary fields like ‘_links’ for cleaner responses.

Input Parameters

string
required
The search query used to filter campaigns. Searches across campaign titles, subject lines, and other campaign content. Returns campaigns that match the specified query terms.
array
A list of fields to return in the response. Use dot notation to reference nested fields (e.g., ‘results.campaign.id’, ‘results.campaign.settings.title’). If not specified, all fields are returned.
array
A list of fields to exclude from the response. Use dot notation to reference nested fields (e.g., ‘results.campaign._links’). Useful for reducing response size by removing unnecessary data.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_SEARCH_FOR_TAGS_ON_A_LIST_BY_NAMESearch for tags on a list by name. If no name is provided, will return all tags on the list.

Input Parameters

string
The search query used to filter tags. The search query will be compared to each tag as a prefix, so all tags that have a name starting with this field will be returned. If not provided, returns all tags on the list.
string
required
The unique ID for the list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_SEARCH_MEMBERSSearch for list members. This search can be restricted to a specific list, or can be used to search across all lists in an account.

Input Parameters

string
required
The search query used to filter results. Query should be a valid email, or a string representing a contact”s first or last name.
array
A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.
string
The unique id for the list. If omitted, search will be performed across all lists in the account.
array
A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_SEND_CAMPAIGNSend a Mailchimp campaign immediately. For RSS Campaigns, the campaign will send according to its schedule. All other campaign types (regular, plaintext, variate) will send immediately upon calling this endpoint. Prerequisites: - Campaign must be in ‘save’ (draft) status - Campaign must have a valid audience (list_id) with at least one recipient - Campaign must have a subject line, from name, and verified from email address - Campaign must have content (HTML or plain text) - The sending account must be in good standing (verified, not disabled) On success, returns HTTP 204 No Content. The campaign status will change to ‘sending’ and then ‘sent’ once all emails are delivered.

Input Parameters

string
required
The unique id for the campaign to send. The campaign must be in ‘save’ status and pass all send-checklist requirements (valid audience, subject line, from name, verified from email domain, and content). Use GET /campaigns/{campaign_id}/send-checklist to verify the campaign is ready before sending.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_SEND_TEST_EMAILSend a test email for a campaign to preview it before sending to your audience. This action allows you to send a test version of your campaign to specified email addresses to verify the content, formatting, and personalization before the final send. The campaign must have content set before a test email can be sent.

Input Parameters

string ("html" | "plaintext")
The format of the test email. Use ‘html’ for the HTML version (default) or ‘plaintext’ for plain-text version.
string
required
The unique ID of the campaign to send a test email for. Must be a valid campaign ID from your Mailchimp account.
array
required
List of email addresses to receive the test email. Free accounts can send to up to 6 addresses, paid accounts up to 20. Example: [‘user1@example.com’, ‘user2@example.com’]

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_SET_CAMPAIGN_CONTENTSet the content for a campaign.

Input Parameters

string
When importing a campaign, the URL where the HTML lives.
string
The raw HTML for the campaign.
string
The plain-text portion of the campaign. If left unspecified, we”ll generate this automatically.
string
required
The unique id for the campaign.
integer
The id of the template to use.
array
Content options for Multivariate Campaigns. Each content option must provide HTML content and may optionally provide plain text. For campaigns not testing content, only one object should be provided.
string ("zip" | "tar.gz" | "tar.bz2" | "tar" | "tgz" | "tbz")
The type of encoded file. Defaults to zip.
string
The base64-encoded representation of the archive file.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_START_AUTOMATED_EMAILStart a specific automated email within an Automation workflow. This action starts sending a specific automated email that is part of a classic automation workflow. The email must be in a ‘paused’ status to be started. Emails in ‘save’ (draft) status may need additional configuration in the Mailchimp web interface before they can be started. Prerequisites: - The automation workflow must exist and not be archived - The automated email must be properly configured (subject line, content, etc.) - The email should be in ‘paused’ status (use Pause Automated Email first if needed) Common error responses: - 400: The automation email is missing requirements and can’t be started - 404: The workflow_id or workflow_email_id was not found

Input Parameters

string
required
The unique ID for the Automation workflow. Use the List Automations action to get available workflow IDs.
string
required
The unique ID for the Automation workflow email to start. Use the List Automated Emails action with the workflow_id to get available email IDs. The email must be in ‘paused’ status to be started; emails in ‘save’ status may require additional configuration in Mailchimp before they can be started.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_START_AUTOMATION_EMAILSStart all emails in a classic automation workflow. This action starts all emails in a specific classic automation workflow. Once started, the automation will begin sending emails to subscribers based on its configured triggers. Prerequisites: - The automation must be in ‘save’ status (not ‘archived’) - The automation must be properly configured with email content - For abandoned cart automations, additional setup may be required in the UI Returns HTTP 204 No Content on success.

Input Parameters

string
required
The unique ID for the Automation workflow. This is a 10-character alphanumeric string (e.g., ‘ae5e650e3b’). You can obtain this ID by listing automations using the LIST_AUTOMATIONS action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_START_BATCH_OPERATIONBegin processing a batch operations request.

Input Parameters

array
required
An array of objects that describes operations to perform.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UNPUBLISH_A_SURVEYUnpublishes a survey that is currently published, making it unavailable for responses. The survey must be in ‘published’ status before calling this action. Prerequisites: The survey must exist on the specified list and be currently published. Surveys are created through the Mailchimp web interface, not via the API. Use ‘Get information about all surveys for a list’ to find available survey IDs, and ‘Get survey’ to verify a survey’s current status before unpublishing. Returns the updated survey details with status changed to ‘unpublished’.

Input Parameters

string
required
The unique ID of the Mailchimp audience (list) containing the survey. You can get this from the ‘Get lists info’ action or from your Mailchimp dashboard under Audience > Settings > Audience name and defaults.
string
required
The unique ID of the survey to unpublish. You can get this from the ‘Get information about all surveys for a list’ action. The survey must be currently published - use ‘Get survey’ to check its status first.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UNPUBLISH_LANDING_PAGEUnpublish a Mailchimp landing page. Takes a published landing page offline, changing its status back to draft. The page URL will no longer be accessible to visitors after unpublishing. This action can also be called on pages that are already in draft status (it will succeed without error). To publish a landing page, use the publish_landing_page action.

Input Parameters

string
required
The unique identifier for the Mailchimp landing page to unpublish. You can get this ID from the list_landing_pages action or when creating a landing page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UNSCHEDULE_CAMPAIGNUnschedule a scheduled campaign that hasn’t started sending. The campaign must be in ‘schedule’ status (not ‘save’, ‘sent’, or ‘sending’). After unscheduling, the campaign status reverts to ‘save’ and can be edited or rescheduled. Returns HTTP 204 No Content on success.

Input Parameters

string
required
The unique id for the campaign to unschedule. The campaign must be in ‘schedule’ status (i.e., previously scheduled but not yet sent). Use list_campaigns with status=‘schedule’ to find scheduled campaigns.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_AUDIENCES_CONTACTSUpdate an existing omni-channel contact in a Mailchimp audience. Use when you need to modify contact details such as language, tags, email/SMS channels, or merge fields.

Input Parameters

array
An array of tag names to add to the contact. This operation is append-only; existing tags will be preserved, and only new tags from this array will be added.
string
The subscriber’s detected language.
string ("historical" | "live")
Indicates the data processing mode. In historical mode, contact data changes do not trigger automations or webhooks. In live mode, such changes do trigger them.
string
required
A unique identifier for the contact, which can be a Mailchimp contact ID or a channel hash. A channel hash must follow the format email:[md5_hash] (where the hash is the MD5 of the lowercased email address) or sms:[sha256_hash] (where the hash is the SHA256 of the E.164-formatted phone number).
string
required
The unique ID for the audience.
object
SMS channel details for the contact.
object
A dictionary of merge fields where the keys are the merge tags. See the Merge Fields documentation for more about the structure.
object
Email channel details for the contact.
string ("ignore_required_checks" | "strict")
Defines how merge field validation is handled. When set to ignore_required_checks, the API does not raise an error if required merge fields are missing. When set to strict, the API enforces validation. If omitted, strict is applied by default.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_BATCH_WEBHOOKUpdate a webhook that will fire whenever any batch request completes processing.

Input Parameters

string
A valid URL for the webhook endpoint. IMPORTANT: Mailchimp validates this URL by making a GET request to it during update. The URL must be publicly accessible and return a successful HTTP response (2xx) to GET requests. Example: https://example.com/webhook/batch
boolean
Whether the webhook is active and receives batch completion notifications.
string
required
The unique identifier for the batch webhook to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_CAMPAIGN_FEEDBACK_MESSAGEUpdate a specific feedback message for a campaign.

Input Parameters

string
The updated content of the feedback message.
integer
The block id for the editable block that the feedback addresses. Use 0 or omit for general campaign feedback not tied to a specific block.
string
required
The unique id for the campaign. Can be obtained from list_campaigns or add_campaign actions.
string
required
The unique id for the feedback message to update. Can be obtained from list_campaign_feedback or add_campaign_feedback actions.
boolean
Whether the feedback is marked as complete/resolved. Set to true to mark feedback as addressed, false to mark as pending.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_CAMPAIGN_FOLDERUpdate the name of a campaign folder in Mailchimp. Campaign folders help organize email marketing campaigns into logical groups. Use this action to rename an existing folder. Returns the updated folder details including the folder ID, new name, and the count of campaigns in the folder.

Input Parameters

string
required
The new name to assign to the campaign folder. This name will be displayed in the Mailchimp interface to help organize campaigns.
string
required
The unique identifier for the campaign folder to update. Can be obtained from the list_campaign_folders action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_CAMPAIGN_SETTINGSUpdate some or all of the settings for a specific campaign.

Input Parameters

string
required
The unique id for the campaign.
string
The title of the campaign.
boolean
Whether to track opens. Defaults to true. Cannot be set to false for variate campaigns.
string
The campaign”s custom “To” name. Typically the first name audience field.
boolean
Whether to enable e-commerce tracking.
string
The reply-to email address for the campaign.
string
The title for the card. Typically the subject line of the campaign.
string
The custom slug for ClickTale tracking (max of 50 bytes).
string
The unique list id.
string
The URL for the RSS feed.
string ("daily" | "weekly" | "monthly")
The frequency of the RSS Campaign.
string
If the campaign is listed in a folder, the id for that folder.
string
The “from” name on the campaign (not an email address).
boolean
Automatically tweet a link to the campaign archive page when the campaign is sent.
boolean
Automatically inline the CSS included with the campaign content.
boolean
Whether Mailchimp authenticated the campaign. Defaults to true.
Automatically append Mailchimp”s default footer to the campaign.
boolean
Allows Facebook comments on the campaign (also force-enables the Campaign Archive toolbar). Defaults to true.
integer
The id of the template to use.
boolean
Whether to track clicks in the HTML version of the campaign. Defaults to true. Cannot be set to false for variate campaigns.
boolean
Whether to track clicks in the plain-text version of the campaign. Defaults to true. Cannot be set to false for variate campaigns.
string
The preview text for the campaign.
string
The subject line for the campaign.
array
An array of Facebook page ids to auto-post to.
string
The url for the header image for the card.
boolean
Update contact notes for a campaign based on subscriber email addresses.
boolean
Deprecated
integer
The hour to send the campaign in local time. Acceptable hours are 0-23. For example, “4” would be 4am in your account”s default time zone.
string
A short summary of the campaign to display.
boolean
Use Mailchimp Conversation feature to manage out-of-office replies.
string
The custom slug for Google Analytics tracking (max of 50 bytes).
boolean
Update contact notes for a campaign based on subscriber email addresses.
integer
The percentage of recipients to send the test combinations to, must be a value between 10 and 100.
integer
The number of minutes to wait before choosing the winning campaign. The value of wait_time must be greater than 0 and in whole hours, specified in minutes.
boolean
Whether to add CSS to images in the RSS feed to constrain their width in campaigns.
boolean
Create a campaign in a connected Salesforce account.
array
The possible from names. The number of from_names provided must match the number of reply_to_addresses. If no from_names are provided, settings.from_name will be used.
array
The possible send times to test. The times provided should be in the format YYYY-MM-DD HH:MM:SS. If send_times are provided to test, the test_size will be set to 100% and winner_criteria will be ignored.
string ("any" | "all")
Segment match type.
array
The possible subject lines to test. If no subject lines are provided, settings.subject_line will be used.
string ("opens" | "clicks" | "manual" | "total_revenue")
The combination that performs the best. This may be determined automatically by click rate, open rate, or total revenue — or you may choose manually based on the reporting data you find the most valuable. For Multivariate Campaigns testing send_time, winner_criteria is ignored. For Multivariate Campaigns with “manual” as the winner_criteria, the winner must be chosen in the Mailchimp web application.
array
Segment match conditions. There are multiple possible types, see the condition types documentation.
string ("sunday" | "monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday")
The day of the week to send a weekly RSS Campaign.
array
The possible reply-to addresses. The number of reply_to_addresses provided must match the number of from_names. If no reply_to_addresses are provided, settings.reply_to will be used.
boolean
Sends the daily RSS Campaign on Fridays.
boolean
Sends the daily RSS Campaign on Mondays.
boolean
Sends the daily RSS Campaign on Sundays.
integer
The day of the month to send a monthly RSS Campaign. Acceptable days are 0-31, where “0” is always the last day of a month. Months with fewer than the selected number of days will not have an RSS campaign sent out that day. For example, RSS Campaigns set to send on the 30th will not go out in February.
boolean
Sends the daily RSS Campaign on Tuesdays.
boolean
Sends the daily RSS Campaign on Saturdays.
boolean
Sends the daily RSS Campaign on Thursdays.
boolean
Sends the daily RSS Campaign on Wednesdays.
integer
The id for an existing saved segment.
string
The prebuilt segment id, if a prebuilt segment has been designated for this campaign.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_CARTUpdate a specific cart.

Input Parameters

array
An array of the cart”s line items.
string
required
The id for the cart.
string
required
The store id.
string
The total tax for the cart (supports decimal values).
string
A string that uniquely identifies the campaign associated with a cart.
string
The order total for the cart (supports decimal values).
string
The URL for the cart. This parameter is required for Abandoned Cart automations.
string
The three-letter ISO 4217 code for the currency that the cart uses.
string
The customer”s company.
string
The customer”s last name.
string
The customer”s first name.
string
The city the customer is located in.
boolean
The customer”s opt-in status. This value will never overwrite the opt-in status of a pre-existing Mailchimp list member, but will apply to list members that are added through the e-commerce API endpoints. Customers who don”t opt in to your Mailchimp list will be added as Transactional members.
string
The customer”s country.
string
The mailing address of the customer.
string
An additional field for the customer”s mailing address.
string
The customer”s state name or normalized province.
string
The customer”s postal or zip code.
string
The two-letter code for the customer”s country.
string
The two-letter code for the customer”s province or state.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_CART_LINE_ITEMUpdate a specific cart line item in a Mailchimp e-commerce store. Use this action to modify the quantity, price, or product association of an existing line item in a shopping cart. All update fields are optional - only provide the fields you want to change. Carts and their line items are typically used for abandoned cart automations.

Input Parameters

number
The unit price of the cart line item in the cart’s currency. Can be a decimal value (e.g., 29.99).
string
required
The unique identifier for the cart containing the line item to update.
string
required
The unique identifier for the cart line item to update.
integer
The number of units of this product variant in the cart. Must be a positive integer.
string
required
The unique identifier for the e-commerce store where the cart resides.
string
The unique identifier for the product to associate with this line item. Must be an existing product in the store.
string
The unique identifier for the product variant. Must be an existing variant of the specified product.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_CUSTOMERUpdate an e-commerce customer’s information in a Mailchimp store. Updates customer details such as name, company, opt-in status, and address. Note: The store must be associated with a Mailchimp list (audience) for this operation to succeed.

Input Parameters

string
The customer’s company name.
string
required
The unique identifier for the e-commerce store. The store must be associated with a Mailchimp list (audience) for customer updates to work.
string
The customer’s last name.
string
The customer’s first name.
string
required
The unique identifier for the customer within the specified store.
string
The city the customer is located in.
boolean
The customer’s opt-in status for marketing emails. This value will never overwrite the opt-in status of a pre-existing Mailchimp list member, but will apply to list members that are added through the e-commerce API endpoints. Customers who don’t opt in to your Mailchimp list will be added as Transactional members.
string
The customer’s country name.
string
The primary mailing address line (street address) of the customer.
string
An additional address line for the customer’s mailing address (apartment, suite, etc.).
string
The customer’s state name or normalized province.
string
The customer’s postal or zip code.
string
The two-letter ISO country code for the customer’s country (e.g., ‘US’ for United States).
string
The two-letter code for the customer’s province or state (e.g., ‘CA’ for California).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_FILEUpdate an existing file’s name or folder in the Mailchimp File Manager. This action allows you to rename a file or move it to a different folder. You can update the name, folder, or both in a single request. At least one of ‘name’ or ‘folder_id’ should be provided to make a meaningful update. To move a file to the root folder, set folder_id to 0. The file’s content and URLs remain unchanged; only the metadata is updated. Returns the updated file’s details including its ID, name, folder, URLs, and metadata.

Input Parameters

string
The new name for the file including extension (e.g., ‘logo.png’, ‘banner.jpg’). Supports Unicode characters. If not specified, the file name remains unchanged.
string
required
The unique ID of the file to update in the File Manager. Use the List Stored Files action to get available file IDs.
integer
The ID of the folder to move the file to. Set to 0 to move the file to the root folder. Use the List Folders action to get available folder IDs. If not specified, the file remains in its current folder.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_FOLDERUpdate the name of a File Manager folder in Mailchimp. Use this action to rename an existing folder in the Mailchimp File Manager. File Manager folders help organize images and other files used in campaigns, templates, and other Mailchimp content. Note: Only the folder name can be updated. The folder ID and creation metadata remain unchanged.

Input Parameters

string
required
The new name for the folder. Must be unique within the account’s File Manager.
string
required
The unique numeric ID for the File Manager folder to update. Obtain this from the ‘list_folders’ or ‘add_folder’ actions.
string
The date and time the folder was created in ISO 8601 format.
string
The name of the user who created the folder.
integer
The number of files in the folder.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_INTEREST_CATEGORYUpdate a specific interest category.

Input Parameters

string ("checkboxes" | "dropdown" | "radio" | "hidden")
Interest category display type for signup forms.
string
required
The text description of this category (required). This field appears on signup forms and is often phrased as a question (e.g., ‘Which topics interest you?’).
string
required
The unique ID for the list (audience). You can find this in the Mailchimp dashboard or via the GET /lists endpoint.
integer
The order that the categories are displayed in the list. Lower numbers display first (e.g., 0 displays before 1).
string
required
The unique ID for the interest category to update. You can find this via the GET /lists/{list_id}/interest-categories endpoint.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_INTEREST_IN_CATEGORYUpdate an interest (group name) within an interest category on a Mailchimp list. Use this action to modify the name or display order of an existing interest. Interests are used to segment subscribers based on their preferences. The ‘name’ parameter is required for this update operation.

Input Parameters

string
required
The name of the interest. This is required and will be shown publicly on subscription forms.
string
required
The unique ID for the list (audience). Use the LIST_INTERESTS_IN_CATEGORY action to find available lists.
string
required
The unique ID of the interest to update. Use the LIST_INTERESTS_IN_CATEGORY action to find interests within a category.
integer
The display order for this interest within the category. Lower numbers appear first.
string
required
The unique ID for the interest category. Use the LIST_INTEREST_CATEGORIES action to find categories for a list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_LANDING_PAGEUpdate a landing page.

Input Parameters

string
The internal name of this landing page used for organization.
string
The title of this landing page shown in the browser’s title bar.
string
The ID of the audience/list associated with this landing page.
string
required
The unique ID of the landing page to update.
string
The ID of the e-commerce store associated with this landing page.
string
The description of this landing page.
boolean
Use cookies to track unique visitors and calculate overall conversion rate. Learn more at https://mailchimp.com/help/use-track-mailchimp/.
boolean
Enable Google’s restricted data processing for CCPA compliance. Restricts how Google uses certain identifiers. Learn more at https://privacy.google.com/businesses/rdp/.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_LIST_MEMBERUpdate information for a specific list member.

Input Parameters

boolean
VIP status for subscriber.
string
The IP address the subscriber used to confirm their opt-in status.
string ("subscribed" | "unsubscribed" | "cleaned" | "pending")
Subscriber’s current status. Use ‘subscribed’, ‘unsubscribed’, ‘cleaned’, or ‘pending’.
string
required
The unique ID for the list.
string
The subscriber’s language code (e.g., ‘en’ for English, ‘es’ for Spanish, ‘fr’ for French).
object
A dictionary mapping interest IDs to boolean values indicating if the subscriber is interested. Example: {‘interest_id_123’: true, ‘interest_id_456’: false}.
string
IP address the subscriber signed up from.
string
Type of email this member asked to get (“html” or “text”).
object
A dictionary of merge fields where the keys are the merge tags. See the Merge Fields documentation for more about the structure.
string
Email address for a subscriber.
string
The date and time the subscriber confirmed their opt-in status in ISO 8601 format.
string
required
The MD5 hash of the lowercase version of the list member’s email address. This endpoint also accepts a list member’s email address or contact_id directly.
string
The date and time the subscriber signed up for the list in ISO 8601 format.
number
The location latitude (decimal degrees, e.g., 40.7128 for New York).
number
The location longitude (decimal degrees, e.g., -74.0060 for New York).
array
The marketing permissions for the subscriber.
boolean
If skip_merge_validation is true, member data will be accepted without merge field values, even if the merge field is usually required. This defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_LISTSUpdate settings for a Mailchimp audience (list), including contact information and campaign defaults. Omitted archive bar, double opt-in, and marketing permissions settings are sent as false.

Input Parameters

string
The name of the list/audience.
string
required
The unique ID for the list.
string
The postal or zip code for the list contact.
boolean
Whether or not to require the subscriber to confirm subscription via email.
string
The city for the list contact.
string
The phone number for the list contact.
string
The state for the list contact.
boolean
Whether campaigns for this list use the Archive Bar in archives by default.
string
The company name for the list contact.
string
A two-character ISO 3166 country code (e.g., ‘US’, ‘GB’).
string
The street address for the list contact (line 1).
string
The street address for the list contact (line 2).
boolean
Whether the list supports multiple formats for emails. When true, subscribers can choose between HTML or plain-text. When false, all subscribers receive HTML with plain-text backup.
string
The email address to send subscribe notifications to. Leave empty or omit to disable notifications.
string
The permission reminder for the list - text that reminds subscribers how they got on the mailing list.
boolean
Whether or not the list has marketing permissions (eg. GDPR) enabled.
string
The email address to send unsubscribe notifications to. Leave empty or omit to disable notifications.
string
The default subject line for campaigns sent to this list.
string
The default language for this list’s forms (e.g., ‘en’).
string
The default ‘From’ name for campaigns sent to this list.
string
The default ‘From’ email for campaigns sent to this list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_LISTS_SEGMENTSUpdate a specific segment in a list. Use when you need to modify segment name, conditions, or static members.

Input Parameters

string
required
The name of the segment.
string
required
The unique ID for the list.
string
required
The unique id for the segment.
string ("any" | "all")
Match type for segment conditions.
array
An array of emails to be used for a static segment. Any emails provided that are not present on the list will be ignored. Passing an empty array for an existing static segment will reset that segment and remove all members. This field cannot be provided with the options field.
array
An array of segment conditions. Each condition should have: ‘condition_type’ (e.g., ‘EmailAddress’, ‘Merge’), ‘field’ (e.g., ‘EMAIL’), ‘op’ (e.g., ‘contains’, ‘is’), and ‘value’. This field cannot be provided with the static_segment field.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_MERGE_FIELDUpdate a specific merge field (audience field) for a Mailchimp list. Use this action to modify properties of an existing merge field such as its name, whether it’s required, default value, display order, help text, and type-specific options. Only provide the fields you want to change.

Input Parameters

string
The merge tag used in Mailchimp campaigns (e.g., |FNAME|). Must be uppercase, alphanumeric, and max 10 characters.
string
The display name of the merge field shown to users (e.g., ‘First Name’).
boolean
Whether the merge field is visible on the signup form.
string
required
The unique ID for the Mailchimp audience (list) containing the merge field.
string
required
The unique numeric ID for the merge field to update.
boolean
Whether the merge field is required when importing or adding contacts.
string
Help text shown to subscribers to assist them in filling out the form.
string
The default value for the merge field when no value is provided.
integer
The display order position of this field on the signup form (lower numbers appear first).
array
For radio or dropdown fields only: the list of options users can select from.
string
For date or birthday fields only: the date format (e.g., ‘MM/DD/YYYY’, ‘DD/MM/YYYY’).
string
For phone fields only: the phone number format. Use ‘US’ or ‘International’.
integer
For address fields only: the default country code if none is provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_NOTEUpdate a specific note for a specific list member.

Input Parameters

string
The content of the note. Note length is limited to 1,000 characters.
string
required
The unique ID for the list.
string
required
The id for the note.
string
required
The MD5 hash of the lowercase version of the list member’s email address. This endpoint also accepts the member’s email address or contact_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_ORDERUpdate a specific order.

Input Parameters

array
An array of the order”s line items.
array
The promo codes applied on the order. Note: Patch will completely replace the value of promos with the new one provided.
string
required
The id for the order in a store.
string
required
The store id.
string
The URL for the order.
integer
The tax total associated with an order.
string
A string that uniquely identifies the campaign associated with an order.
integer
The order total associated with an order.
string
The URL for the page where the buyer landed when entering the shop.
string
A unique identifier for the outreach. Can be an email campaign ID.
string
The tracking URL associated with the order.
string
The three-letter ISO 4217 code for the currency that the store accepts.
string ("prec")
The Mailchimp tracking code for the order. Uses the “mc_tc” parameter in E-Commerce tracking URLs.
integer
The total amount of the discounts to be applied to the price of the order.
integer
The shipping total for the order.
string
The tracking number associated with the order.
string
The order status. Use this parameter to trigger Order Notifications.
string
The tracking carrier associated with the order.
string
The customer”s company.
string
The fulfillment status for the order. Use this parameter to trigger Order Notifications.
string
The date and time the order was updated in ISO 8601 format.
string
The date and time the order was cancelled in ISO 8601 format. Note: passing a value for this parameter will cancel the order being edited.
string
The customer”s last name.
string
The date and time the order was processed in ISO 8601 format.
string
The customer”s first name.
string
The city in the billing address.
string
The name associated with an order”s billing address.
string
The phone number for the billing address.
string
The city the customer is located in.
string
The city in the order”s shipping address.
string
The name associated with an order”s shipping address.
string
The phone number for the order”s shipping address
string
The company associated with the billing address.
string
The country in the billing address.
boolean
The customer”s opt-in status. This value will never overwrite the opt-in status of a pre-existing Mailchimp list member, but will apply to list members that are added through the e-commerce API endpoints. Customers who don”t opt in to your Mailchimp list will be added as Transactional members.
string
The billing address for the order.
string
An additional field for the billing address.
integer
The latitude for the billing address location.
string
The state or normalized province in the billing address.
string
The customer”s country.
string
The company associated with an order”s shipping address.
string
The country in the order”s shipping address.
integer
The longitude for the billing address location.
string
The mailing address of the customer.
string
An additional field for the customer”s mailing address.
string
The customer”s state name or normalized province.
string
The shipping address for the order.
string
An additional field for the shipping address.
integer
The latitude for the shipping address location.
string
The state or normalized province in the order”s shipping address.
integer
The longitude for the shipping address location.
string
The postal or zip code in the billing address.
string
The two-letter code for the country in the billing address.
string
The customer”s postal or zip code.
string
The postal or zip code in the order”s shipping address.
string
The two-letter code for the province or state in the billing address.
string
The two-letter code for the customer”s country.
string
The two-letter code for the country in the shipping address.
string
The two-letter code for the customer”s province or state.
string
The two-letter code for the province or state the order”s shipping address is located in.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_ORDER_LINE_ITEMUpdate a specific order line item.

Input Parameters

number
The price of an order line item.
string
required
The id for the line item of an order.
number
The total discount amount applied to this line item.
string
required
The id for the order in a store.
integer
The quantity of an order line item.
string
required
The store id.
string
A unique identifier for the product associated with the order line item.
string
A unique identifier for the product variant associated with the order line item.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_PRODUCTUpdate a specific product.

Input Parameters

string
The URL for a product.
string
The type of product.
string
The title of a product.
string
The handle of a product.
array
An array of the product”s images.
string
The vendor for a product.
string
required
The store id.
array
An array of the product”s variants. At least one variant is required for each product. A variant can use the same id and title as the parent product.
string
The image URL for a product.
string
required
The id for the product of a store.
string
The description of a product.
string
The date and time the product was published in ISO 8601 format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_PRODUCT_IMAGEUpdate a product image in a Mailchimp e-commerce store. Use this action to modify an existing product image’s URL or associate it with specific product variants. Requires valid store_id, product_id, and image_id. At least one of ‘url’ or ‘variant_ids’ must be provided in the request body.

Input Parameters

string
A new unique identifier for the product image. Optional - only provide if you want to change the image ID.
string
The new URL for the product image. Must be a valid image URL. At least one of ‘url’ or ‘variant_ids’ should be provided.
string
required
The unique identifier for the product image to update. Required.
string
required
The unique identifier for the e-commerce store. Required.
string
required
The unique identifier for the product within the store. Required.
array
List of product variant IDs to associate with this image. Use to link the image to specific product variants (e.g., color/size variations).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_PRODUCT_VARIANTUpdate a product variant.

Input Parameters

string
The stock keeping unit (SKU) of a product variant.
string
The URL for a product variant.
number
The price of a product variant.
string
The title of a product variant.
string
required
The store id.
string
The image URL for a product variant.
string
The backorders of a product variant.
string
required
The id for the product of a store.
string
required
The id for the product variant.
string
The visibility of a product variant.
integer
The inventory quantity of a product variant.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_PROMO_CODEUpdate a promo code.

Input Parameters

string
The discount code. Restricted to UTF-8 characters with max length 50.
boolean
Whether the promo code is currently enabled.
string
required
The store id.
integer
Number of times promo code has been used.
string
required
The id for the promo code of a store.
string
required
The id for the promo rule of a store.
string
The url that should be used in the promotion campaign restricted to UTF-8 characters with max length 2000.
string
The date and time the promotion was created in ISO 8601 format.
string
The date and time the promotion was updated in ISO 8601 format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_PROMO_RULEUpdate an existing promo rule for an e-commerce store. Promo rules define discount promotions that can be applied to orders, items, or shipping. Only the fields provided will be updated.

Input Parameters

string ("fixed" | "percentage")
Type of discount. For free shipping set type to fixed.
string
The title that will show up in promotion campaign. Restricted to UTF-8 characters with max length of 100 bytes.
number
The amount of the promo code discount. If “type” is “fixed”, the amount is treated as a monetary value. If “type” is “percentage”, amount must be a decimal value between 0.0 and 1.0, inclusive.
string ("per_item" | "total" | "shipping")
The target that the discount applies to.
boolean
Whether the promo rule is currently enabled.
string
The date and time when the promotion ends. Must be after starts_at and in ISO 8601 format.
string
required
The unique identifier for the e-commerce store.
string
The date and time when the promotion is in effect in ISO 8601 format.
string
The description of a promotion restricted to UTF-8 characters with max length 255.
string
required
The unique identifier for the promo rule to update.
string
The date and time the promotion was created in ISO 8601 format.
string
The date and time the promotion was updated in ISO 8601 format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_STOREUpdate a store.

Input Parameters

string
The name of the store.
string
The store phone number.
string
The store domain.
string
The e-commerce platform of the store.
string
required
The store id.
string
The timezone for the store.
boolean
Whether to disable automations because the store is currently syncing.
string
The currency format for the store. For example: $, £, etc.
string
The city the store is located in.
string
The three-letter ISO 4217 code for the currency that the store accepts.
string
The email address for the store.
string
The primary locale for the store. For example: en, de, etc.
string
The store”s country.
string
The store”s mailing address.
string
An additional field for the store”s mailing address.
integer
The latitude of the store location.
string
The store”s state name or normalized province.
integer
The longitude of the store location.
string
The store”s postal or zip code.
string
The two-letter code for to the store”s country.
string
The two-letter code for the store”s province or state.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_TEMPLATEUpdate an existing template’s name and HTML, and optionally its folder assignment. Both name and HTML are required.

Input Parameters

string
required
The raw HTML for the template. Supports the Mailchimp Template Language (e.g., |FNAME|, |LNAME|) for personalization. See: https://mailchimp.com/help/getting-started-with-mailchimps-template-language/
string
required
The name of the template.
string
The id of the folder to assign the template to. Pass an empty string to remove from folder.
string
required
The unique id for the template.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_TEMPLATE_FOLDERUpdate the name of an existing template folder in Mailchimp. Template folders help organize email templates for easier management. Use this action to rename a folder. The folder_id can be obtained from the add_template_folder or list_template_folders actions. Returns the updated folder information including the new name, folder ID, and the count of templates contained in the folder.

Input Parameters

string
required
The new name for the template folder. This will replace the existing folder name.
string
required
The unique ID of the template folder to update. Obtain this ID from the response of add_template_folder or list_template_folders actions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_WEBHOOKUpdate the settings for an existing webhook in a Mailchimp list (audience). This action allows you to modify the URL, event triggers, and source triggers of a webhook. Only the settings you provide will be updated; other settings will remain unchanged.

Input Parameters

string
A valid, publicly accessible URL for the webhook endpoint. Mailchimp will verify this URL is reachable before updating.
string
required
The unique ID for the list (audience). Use MAILCHIMP_GET_LISTS_INFO to retrieve available list IDs.
string
required
The unique ID of the webhook to update. Use MAILCHIMP_LIST_WEBHOOKS to retrieve available webhook IDs for a list.
boolean
Whether the webhook is triggered by actions initiated via the API.
boolean
Whether the webhook is triggered by subscriber-initiated actions.
boolean
Whether the webhook is triggered by admin-initiated actions in the web interface.
boolean
Whether the webhook is triggered when a subscriber’s email address is cleaned from the list.
boolean
Whether the webhook is triggered when a subscriber’s profile is updated.
boolean
Whether the webhook is triggered when a subscriber’s email address is changed.
boolean
Whether the webhook is triggered when a campaign is sent or cancelled.
boolean
Whether the webhook is triggered when a list subscriber is added.
boolean
Whether the webhook is triggered when a list member unsubscribes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPDATE_WORKFLOW_EMAILUpdate settings for a classic automation workflow email. Only works with workflows of type: abandonedBrowse, abandonedCart, emailFollowup, or singleWelcome.

Input Parameters

string ("now" | "day" | "hour" | "week")
The type of delay for an automation email.
string
required
The unique id for the Automation workflow.
string ("signup" | "ecomm_abandoned_browse" | "ecomm_abandoned_cart")
The action that triggers the delay of an automation emails.
integer
The delay amount for an automation email.
string
The title of the Automation.
string ("after")
Whether the delay settings describe before or after the delay action of an automation email.
string
required
The unique id for the Automation workflow email.
string
The reply-to email address for the Automation.
string
The “from” name for the Automation (not an email address).
string
The preview text for the campaign.
string
The subject line for the campaign.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPSERT_ECOMMERCE_STORES_ORDERSAdd or update an e-commerce order in a Mailchimp store. Uses PUT semantics - if the order exists it will be updated, otherwise a new order will be created. The order_id in the path and the id in the request body should match.

Input Parameters

string
required
A unique identifier for the order. This should match the order_id path parameter.
array
An array of the order’s line items. Each line item must include: ‘id’ (string, required - unique identifier for the line item), ‘product_id’ (string - unique identifier for the product), ‘product_variant_id’ (string - unique identifier for the product variant), ‘quantity’ (integer - quantity of the line item), ‘price’ (number - price of the line item). Optional: ‘product_title’, ‘product_variant_title’, ‘discount’, ‘product’ (object with product details).
array
The promo codes applied on the order. Each promo object should contain ‘code’ (string, required), ‘amount_discounted’ (number, required), and ‘type’ (string, required).
string
A cart id that the order was placed for.
string
required
The unique identifier for the order in the store. This is used in the URL path and should match the ‘id’ field in the request body.
string
required
The unique identifier for the e-commerce store.
string
The URL for the order.
number
The tax total for the order.
string
A string that uniquely identifies the campaign for an order.
number
The total for the order.
string
required
A unique identifier for the customer associated with this order. Required. Limited to 50 characters.
string
The URL for the page where the buyer landed when entering the shop.
string
A unique identifier for the outreach. Can be an email campaign ID.
string
The tracking URL associated with the order.
string
The three-letter ISO 4217 code for the currency that the store accepts.
string ("prec")
The Mailchimp tracking code for the order. Uses the ‘mc_tc’ parameter in E-Commerce tracking URLs.
number
The total amount of the discounts to be applied to the price of the order.
number
The shipping total for the order.
string
The tracking number associated with the order.
string
The order status. Use this parameter to trigger Order Notifications.
string
The tracking carrier associated with the order.
string
The customer’s company.
string
The fulfillment status for the order. Use this parameter to trigger Order Notifications.
string
The date and time the order was updated in ISO 8601 format.
string
The date and time the order was cancelled in ISO 8601 format. Note: passing a value for this parameter will cancel the order being created.
string
The customer’s last name.
string
The date and time the order was processed in ISO 8601 format.
string
The customer’s first name.
string
The city in the billing address.
string
The name associated with the billing address.
string
The phone number for the billing address.
string
The city the customer is located in.
string
The city in the order’s shipping address.
string
The name associated with an order’s shipping address.
string
The customer’s email address.
string
The phone number for the order’s shipping address.
string
The company associated with the billing address.
string
The country in the billing address.
boolean
The customer’s opt-in status. This value will never overwrite the opt-in status of a pre-existing Mailchimp list member, but will apply to list members that are added through the e-commerce API endpoints. Customers who don’t opt in to your Mailchimp list will be added as Transactional members.
string
The billing address for the order.
string
An additional field for the billing address.
number
The latitude for the billing address location.
string
The state or normalized province in the billing address.
string
The customer’s country.
string
The company associated with the shipping address.
string
The country in the shipping address.
number
The longitude for the billing address location.
string
The mailing address of the customer.
string
An additional field for the customer’s mailing address.
string
The customer’s state name or normalized province.
string
The shipping address for the order.
string
An additional field for the shipping address.
number
The latitude for the shipping address location.
string
The state or normalized province in the order’s shipping address.
number
The longitude for the shipping address location.
string
The postal or zip code in the billing address.
string
The two-letter code for the country in the billing address.
string
The customer’s postal or zip code.
string
The postal or zip code in the shipping address.
string
The two-letter code for the province in the billing address.
string
The two-letter code for the customer’s country.
string
The two-letter code for the country in the shipping address.
string
The two-letter code for the customer’s province or state.
string
The two-letter code for the province or state in the shipping address.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_UPSERT_ECOMMERCE_STORES_PRODUCTSCreate or update a product in a Mailchimp e-commerce store. Use when you need to add a new product or update an existing product with idempotent behavior. This endpoint uses PUT semantics - if the product exists, it will be updated; if not, a new product will be created.

Input Parameters

string
required
A unique identifier for the product.
string
The URL for a product.
string
The type of product.
string
required
The title of a product.
string
The handle of a product.
array
An array of the product’s images.
string
The vendor for a product.
string
required
The store id.
array
required
An array of the product’s variants. At least one variant is required for each product. A variant can use the same id and title as the parent product.
string
The image URL for a product.
string
required
The id for the product of a store.
string
The description of a product.
string
The date and time the product was published.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_VERIFY_CONNECTED_SITE_SCRIPTVerify that the Mailchimp connected site tracking script has been installed on the website. This checks if the script is properly installed either via the script URL or HTML fragment. Use this to confirm a connected site’s tracking integration is working correctly. Returns HTTP 204 on success (script is installed) or HTTP 404 if the site is not found.

Input Parameters

string
required
The unique identifier for the connected site (foreign_id). Obtain this from LIST_CONNECTED_SITES or ADD_CONNECTED_SITE actions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_VERIFY_DOMAINComplete domain verification by submitting the verification code. This action completes the domain verification process started by ‘add_domain_to_account’. When a domain is added, a verification email is sent to the specified email address containing a unique verification code. Use this action to submit that code and complete the verification. Once verified, the domain can be used as a sender address in campaigns. Prerequisites: - Domain must be added first using ‘add_domain_to_account’ - Domain status should be ‘VERIFICATION_IN_PROGRESS’ - You need the verification code from the email sent during domain addition Common errors: - 400: Invalid verification code - the code doesn’t match or has expired - 404: Domain not found - the domain hasn’t been added to the account

Input Parameters

string
required
The verification code from the email sent to the verification_email address when the domain was added via ‘add_domain_to_account’. This is a unique code used to confirm ownership of the domain.
string
required
The domain name to verify (e.g., ‘yourdomain.com’). This must be a domain that was previously added via ‘add_domain_to_account’ and is in VERIFICATION_IN_PROGRESS status.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_VIEW_DEFAULT_CONTENTGet the sections that you can edit in a template, including each section’s default content.

Input Parameters

array
A list of fields to return in the response. Use dot notation to reference nested fields (e.g., [‘sections’, ‘_links’]). If not specified, all fields are returned.
string
required
The unique ID of the template to retrieve default content for.
array
A list of fields to exclude from the response. Use dot notation to reference nested fields (e.g., [‘_links’]). Cannot be used together with ‘fields’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_VIEW_RECENT_ACTIVITYGet a member’s activity on a specific list, including opens, clicks, and unsubscribes.

Input Parameters

integer
The number of records to return. Default value is 10. Maximum value is 1000
array
A list of fields to return in the response. Use dot notation for nested fields (e.g., ‘activity.activity_type’). Example: [‘activity’, ‘email_id’, ‘list_id’].
integer
Used for pagination, this it the number of records from a collection to skip. Default value is 0.
string
required
The unique ID for the list.
array
A list of fields to exclude from the response. Use dot notation for nested fields (e.g., ‘activity.avatar_url’). Example: [‘_links’].
string
required
The MD5 hash of the lowercase version of the list member”s email address. This endpoint also accepts a list member”s email address or contact_id.
array
A list of activity type filters. Valid values include: ‘open’, ‘click’, ‘bounce’, ‘unsub’, ‘sent’, ‘note’, ‘abuse’, ‘ecomm’. Example: [‘open’, ‘click’].

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILCHIMP_VIEW_RECENT_ACTIVITY50Get the last 50 events of a member’s activity on a specific list, including opens, clicks, and unsubscribes.

Input Parameters

array
List of activity types to filter by (e.g., [‘open’, ‘click’, ‘bounce’, ‘unsub’, ‘sent’, ‘ecomm’, ‘abuse’]).
array
List of fields to return (e.g., [‘activity.action’, ‘activity.timestamp’]). Use dot notation to reference sub-object parameters.
string
required
The unique ID for the list.
array
List of fields to exclude from response (e.g., [‘_links’]). Use dot notation to reference sub-object parameters.
string
required
The MD5 hash of the lowercase version of the list member”s email address. This endpoint also accepts a list member”s email address or contact_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not

Triggers

Slug: MAILCHIMP_CAMPAIGN_TRIGGERType: webhookTriggered when a campaign is sent or experiences an event in Mailchimp

Configuration

string
required
The Mailchimp list/audience ID to monitor

Payload

string
Email address of the subscriber
string
Type of event
string
ID of the list/audience
object
Custom merge fields/data
string
When the event occurred
Slug: MAILCHIMP_PROFILE_UPDATE_TRIGGERType: webhookTriggered when a subscriber’s profile is updated in Mailchimp

Configuration

string
required
The Mailchimp list/audience ID to monitor

Payload

string
Email address of the subscriber
string
Type of event
string
ID of the list/audience
object
Custom merge fields/data
string
When the event occurred
Slug: MAILCHIMP_SUBSCRIBE_TRIGGERType: webhookTriggered when a subscriber subscribes to Mailchimp

Configuration

string
required
The Mailchimp list/audience ID to monitor

Payload

string
Email address of the subscriber
string
Type of event
string
ID of the list/audience
object
Custom merge fields/data
string
When the event occurred
Slug: MAILCHIMP_UNSUBSCRIBE_TRIGGERType: webhookTriggered when a subscriber unsubscribes from Mailchimp

Configuration

string
required
The Mailchimp list/audience ID to monitor

Payload

string
Email address of the subscriber
string
Type of event
string
ID of the list/audience
object
Custom merge fields/data
string
When the event occurred