Mailchimp

Learn how to use Mailchimp with Composio

Overview

Enum

MAILCHIMP

Description

Mailchimp is an email marketing and automation platform providing campaign templates, audience segmentation, and performance analytics to drive engagement and conversions

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
string
dc
stringDefaults to us21Required

Actions

Get a summary of an account’s classic automations.

Action Parameters

count
integerDefaults to 10
offset
integer
fields
array
exclude_fields
array
before_create_time
string
since_create_time
string
before_start_time
string
since_start_time
string
status
string

Action Response

data
object
successful
boolean
error

Delete a product.

Action Parameters

store_id
stringRequired
product_id
stringRequired

Action Response

data
object
successful
boolean
error

Update a specific cart line item.

Action Parameters

store_id
stringRequired
cart_id
stringRequired
line_id
stringRequired
product_id
string
product_variant_id
string
quantity
integer
price
integer

Action Response

data
object
successful
boolean
error

Get information about a specific order line item.

Action Parameters

fields
array
exclude_fields
array
store_id
stringRequired
order_id
stringRequired
line_id
stringRequired

Action Response

data
object
successful
boolean
error

Create a new template for the account. only classic templates are supported.

Action Parameters

name
stringRequired
folder_id
string
html
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a store’s promo rules.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
store_id
stringRequired

Action Response

data
object
successful
boolean
error

Get answers for a survey question.

Action Parameters

fields
array
exclude_fields
array
survey_id
stringRequired
question_id
stringRequired
respondent_familiarity_is
string

Action Response

data
object
successful
boolean
error

Get information about a specific authorized application.

Action Parameters

fields
array
exclude_fields
array
app_id
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a specific merge field.

Action Parameters

list_id
stringRequired
merge_id
stringRequired
exclude_fields
array
fields
array

Action Response

data
object
successful
boolean
error

Update a specific file manager folder.

Action Parameters

folder_id
stringRequired
name
stringRequired

Action Response

data
object
successful
boolean
error

Verify a domain for sending.

Action Parameters

domain_name
stringRequired
code
stringRequired

Action Response

data
object
successful
boolean
error

Create a new mailchimp connected site.

Action Parameters

foreign_id
stringRequired
domain
stringRequired

Action Response

data
object
successful
boolean
error

Create a new campaign folder.

Action Parameters

name
stringRequired

Action Response

data
object
successful
boolean
error

Get a list of all merge fields for an audience.

Action Parameters

list_id
stringRequired
fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
type
string
required
boolean

Action Response

data
object
successful
boolean
error

Get information about a specific store.

Action Parameters

fields
array
exclude_fields
array
store_id
stringRequired

Action Response

data
object
successful
boolean
error

Update a customer.

Action Parameters

store_id
stringRequired
customer_id
stringRequired
opt_in_status
boolean
company
string
first_name
string
last_name
string
address__address1
string
address__address2
string
address__city
string
address__province
string
address__province__code
string
address__postal__code
string
address__country
string
address__country__code
string

Action Response

data
object
successful
boolean
error

Get a summary of a specific list’s growth activity for a specific month and year.

Action Parameters

fields
array
exclude_fields
array
list_id
stringRequired
month
stringRequired

Action Response

data
object
successful
boolean
error

Get the last 50 goal events for a member on a specific list.

Action Parameters

list_id
stringRequired
subscriber_hash
stringRequired
fields
array
exclude_fields
array

Action Response

data
object
successful
boolean
error

Get a single survey response.

Action Parameters

survey_id
stringRequired
response_id
stringRequired

Action Response

data
object
successful
boolean
error

Add a domain to the account.

Action Parameters

verification_email
stringRequired

Action Response

data
object
successful
boolean
error

Set the content for a campaign.

Action Parameters

campaign_id
stringRequired
plain_text
string
html
string
url
string
template__id
integer
archive__archive__content
string
archive__archive__type
string
variate_contents
array

Action Response

data
object
successful
boolean
error

Schedule a campaign for delivery. if you’re using multivariate campaigns to test send times or sending rss campaigns, use the send action instead.

Action Parameters

campaign_id
stringRequired
schedule_time
stringRequired
timewarp
boolean
batch__delivery__batch__delay
integer
batch__delivery__batch__count
integer

Action Response

data
object
successful
boolean
error

Delete a specific webhook in a list.

Action Parameters

list_id
stringRequired
webhook_id
stringRequired

Action Response

data
object
successful
boolean
error

Get a list of all folders in the file manager.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
created_by
string
before_created_at
string
since_created_at
string

Action Response

data
object
successful
boolean
error

Configure a webhook that will fire whenever any batch request completes processing. you may only have a maximum of 20 batch webhooks.

Action Parameters

url
stringRequired
enabled
boolean

Action Response

data
object
successful
boolean
error

Get information about a specific customer.

Action Parameters

fields
array
exclude_fields
array
store_id
stringRequired
customer_id
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a specific batch webhook.

Action Parameters

fields
array
exclude_fields
array
batch_webhook_id
stringRequired

Action Response

data
object
successful
boolean
error

Upload a new image or file to the file manager.

Action Parameters

folder_id
integer
name
stringRequired
file_data
stringRequired

Action Response

data
object
successful
boolean
error

Get a member’s activity on a specific list, including opens, clicks, and unsubscribes.

Action Parameters

list_id
stringRequired
subscriber_hash
stringRequired
fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
activity_filters
array

Action Response

data
object
successful
boolean
error

Get the tags on a list member.

Action Parameters

list_id
stringRequired
subscriber_hash
stringRequired
fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer

Action Response

data
object
successful
boolean
error

Get information about an individual classic automation workflow email.

Action Parameters

workflow_id
stringRequired
workflow_email_id
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a specific webhook.

Action Parameters

list_id
stringRequired
webhook_id
stringRequired

Action Response

data
object
successful
boolean
error

Update a specific cart.

Action Parameters

store_id
stringRequired
cart_id
stringRequired
customer__opt__in__status
boolean
customer__company
string
customer__first__name
string
customer__last__name
string
customer__address__address1
string
customer__address__address2
string
customer__address__city
string
customer__address__province
string
customer__address__province__code
string
customer__address__postal__code
string
customer__address__country
string
customer__address__country__code
string
campaign_id
string
checkout_url
string
currency_code
string
order_total
integer
tax_total
integer
lines
array

Action Response

data
object
successful
boolean
error

Delete a product variant.

Action Parameters

store_id
stringRequired
product_id
stringRequired
variant_id
stringRequired

Action Response

data
object
successful
boolean
error

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.

Action Parameters

workflow_id
stringRequired

Action Response

data
object
successful
boolean
error

Create a trigger step in the customer journey builder via the api. use the provided url with {journey_id} and {step_id} to activate conditions for a contact.

Action Parameters

journey_id
integerRequired
step_id
integerRequired
email_address
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a specific template.

Action Parameters

fields
array
exclude_fields
array
template_id
stringRequired

Action Response

data
object
successful
boolean
error

Delete all personally identifiable information related to a list member, and remove them from a list. this will make it impossible to re-import the list member.

Action Parameters

list_id
stringRequired
subscriber_hash
stringRequired

Action Response

data
object
successful
boolean
error

Update interests or ‘group names’ for a specific category.

Action Parameters

list_id
stringRequired
interest_category_id
stringRequired
interest_id
stringRequired
name
stringRequired
display_order
integer

Action Response

data
object
successful
boolean
error

Add a new cart to a store.

Action Parameters

store_id
stringRequired
id
stringRequired
customer__id
string
customer__email__address
string
customer__opt__in__status
boolean
customer__company
string
customer__first__name
string
customer__last__name
string
customer__address__address1
string
customer__address__address2
string
customer__address__city
string
customer__address__province
string
customer__address__province__code
string
customer__address__postal__code
string
customer__address__country
string
customer__address__country__code
string
campaign_id
string
checkout_url
string
currency_code
stringRequired
order_total
integerRequired
tax_total
integer
lines
arrayRequired

Action Response

data
object
successful
boolean
error

Get information about a specific page.

Action Parameters

fields
array
exclude_fields
array
page_id
stringRequired

Action Response

data
object
successful
boolean
error

Update a specific merge field.

Action Parameters

list_id
stringRequired
merge_id
stringRequired
tag
string
name
stringRequired
required
boolean
default_value
string
public
boolean
display_order
integer
options__default__country
integer
options__phone__format
string
options__date__format
string
options__choices
array
help_text
string

Action Response

data
object
successful
boolean
error

Get information about a specific abuse report for a campaign.

Action Parameters

fields
array
exclude_fields
array
campaign_id
stringRequired
report_id
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a specific cart line item.

Action Parameters

fields
array
exclude_fields
array
store_id
stringRequired
cart_id
stringRequired
line_id
stringRequired

Action Response

data
object
successful
boolean
error

Remove a batch webhook. webhooks will no longer be sent to the given url.

Action Parameters

batch_webhook_id
stringRequired

Action Response

data
object
successful
boolean
error

Update a store.

Action Parameters

store_id
stringRequired
name
string
platform
string
domain
string
is_syncing
boolean
email_address
string
currency_code
string
money_format
string
primary_locale
string
timezone
string
phone
string
address__address1
string
address__address2
string
address__city
string
address__province
string
address__province__code
string
address__postal__code
string
address__country
string
address__country__code
string
address__longitude
integer
address__latitude
integer

Action Response

data
object
successful
boolean
error

Add a new merge field for a specific audience.

Action Parameters

list_id
stringRequired
tag
string
name
stringRequired
type
stringRequired
required
boolean
default_value
string
public
boolean
display_order
integer
options__default__country
integer
options__phone__format
string
options__date__format
string
options__choices
array
options__size
integer
help_text
string

Action Response

data
object
successful
boolean
error

Get information about a store’s orders.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
store_id
stringRequired
customer_id
string
has_outreach
boolean
campaign_id
string
outreach_id
string

Action Response

data
object
successful
boolean
error

Get information about an order’s line items.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
store_id
stringRequired
order_id
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a specific product variant.

Action Parameters

fields
array
exclude_fields
array
store_id
stringRequired
product_id
stringRequired
variant_id
stringRequired

Action Response

data
object
successful
boolean
error

Cancel a regular or plain-text campaign after you send, before all of your recipients receive it. this feature is included with mailchimp pro.

Action Parameters

campaign_id
stringRequired

Action Response

data
object
successful
boolean
error

Get feedback based on a campaign’s statistics. advice feedback is based on campaign stats like opens, clicks, unsubscribes, bounces, and more.

Action Parameters

fields
array
exclude_fields
array
campaign_id
stringRequired

Action Response

data
object
successful
boolean
error

Add a new note for a specific subscriber.

Action Parameters

list_id
stringRequired
subscriber_hash
stringRequired
note
string

Action Response

data
object
successful
boolean
error

Get information about a specific list member who unsubscribed from a campaign.

Action Parameters

fields
array
exclude_fields
array
campaign_id
stringRequired
subscriber_hash
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a store’s customers.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
store_id
stringRequired
email_address
string

Action Response

data
object
successful
boolean
error

Get a list of this category’s interests.

Action Parameters

list_id
stringRequired
interest_category_id
stringRequired
fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer

Action Response

data
object
successful
boolean
error

Api endpoint for conversations is deprecated, replaced by inbox. although historical data is accessible, new campaign replies and messages are not retrievable through this endpoint.

Action Parameters

fields
array
exclude_fields
array
conversation_id
stringRequired

Action Response

data
object
successful
boolean
error

Get all folders used to organize templates.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer

Action Response

data
object
successful
boolean
error

Add a new image to the product.

Action Parameters

store_id
stringRequired
product_id
stringRequired
id
stringRequired
url
stringRequired
variant_ids
array

Action Response

data
object
successful
boolean
error

Delete a specific template.

Action Parameters

template_id
stringRequired

Action Response

data
object
successful
boolean
error

Delete an order.

Action Parameters

store_id
stringRequired
order_id
stringRequired

Action Response

data
object
successful
boolean
error

Add a new line item to an existing cart.

Action Parameters

store_id
stringRequired
cart_id
stringRequired
id
stringRequired
product_id
stringRequired
product_variant_id
stringRequired
quantity
integerRequired
price
integerRequired

Action Response

data
object
successful
boolean
error

Get information about a specific subscriber who was removed from a classic automation workflow.

Action Parameters

workflow_id
stringRequired
subscriber_hash
stringRequired

Action Response

data
object
successful
boolean
error

Remove a campaign from your mailchimp account.

Action Parameters

campaign_id
stringRequired

Action Response

data
object
successful
boolean
error

Add or update a list member.

Action Parameters

list_id
stringRequired
subscriber_hash
stringRequired
skip_merge_validation
boolean
email_address
stringRequired
status_if_new
stringRequired
email_type
string
status
string
merge_fields
object
interests
object
language
string
vip
boolean
location__latitude
integer
location__longitude
integer
marketing_permissions
array
ip_signup
string
timestamp_signup
string
ip_opt
string
timestamp_opt
string

Action Response

data
object
successful
boolean
error

Add a new promo code to a store.

Action Parameters

store_id
stringRequired
promo_rule_id
stringRequired
id
stringRequired
code
stringRequired
redemption_url
stringRequired
usage_count
integer
enabled
boolean
created_at_foreign
string
updated_at_foreign
string

Action Response

data
object
successful
boolean
error

Get the the html for your landing page.

Action Parameters

fields
array
exclude_fields
array
page_id
stringRequired

Action Response

data
object
successful
boolean
error

Update a specific order.

Action Parameters

store_id
stringRequired
order_id
stringRequired
customer__opt__in__status
boolean
customer__company
string
customer__first__name
string
customer__last__name
string
customer__address__address1
string
customer__address__address2
string
customer__address__city
string
customer__address__province
string
customer__address__province__code
string
customer__address__postal__code
string
customer__address__country
string
customer__address__country__code
string
campaign_id
string
landing_site
string
financial_status
string
fulfillment_status
string
currency_code
string
order_total
integer
order_url
string
discount_total
integer
tax_total
integer
shipping_total
integer
tracking_code
string
processed_at_foreign
string
cancelled_at_foreign
string
updated_at_foreign
string
shipping__address__name
string
shipping__address__address1
string
shipping__address__address2
string
shipping__address__city
string
shipping__address__province
string
shipping__address__province__code
string
shipping__address__postal__code
string
shipping__address__country
string
shipping__address__country__code
string
shipping__address__longitude
integer
shipping__address__latitude
integer
shipping__address__phone
string
shipping__address__company
string
billing__address__name
string
billing__address__address1
string
billing__address__address2
string
billing__address__city
string
billing__address__province
string
billing__address__province__code
string
billing__address__postal__code
string
billing__address__country
string
billing__address__country__code
string
billing__address__longitude
integer
billing__address__latitude
integer
billing__address__phone
string
billing__address__company
string
promos
array
lines
array
outreach__id
string
tracking_number
string
tracking_carrier
string
tracking_url
string

Action Response

data
object
successful
boolean
error

Customize a list’s default signup form.

Action Parameters

list_id
stringRequired
header__image__url
string
header__text
string
header__image__width
string
header__image__height
string
header__image__alt
string
header__image__link
string
header__image__align
string
header__image__border__width
string
header__image__border__style
string
header__image__border__color
string
header__image__target
string
contents
array
styles
array

Action Response

data
object
successful
boolean
error

Return the chimp chatter for this account ordered by most recent.

Action Parameters

count
integerDefaults to 10
offset
integer

Action Response

data
object
successful
boolean
error

Get information about a specific folder used to organize templates.

Action Parameters

fields
array
exclude_fields
array
folder_id
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a store’s promo codes.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
promo_rule_id
stringRequired
store_id
stringRequired

Action Response

data
object
successful
boolean
error

Send a mailchimp campaign. for rss campaigns, the campaign will send according to its schedule. all other campaigns will send immediately.

Action Parameters

campaign_id
stringRequired

Action Response

data
object
successful
boolean
error

Get all webhooks that have been configured for batches.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer

Action Response

data
object
successful
boolean
error

Get signup forms for a specific list.

Action Parameters

list_id
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a specific folder used to organize campaigns.

Action Parameters

fields
array
exclude_fields
array
folder_id
stringRequired

Action Response

data
object
successful
boolean
error

Update a product variant.

Action Parameters

store_id
stringRequired
product_id
stringRequired
variant_id
stringRequired
title
string
url
string
sku
string
price
integer
inventory_quantity
integer
image_url
string
backorders
string
visibility
string

Action Response

data
object
successful
boolean
error

Get information about a specific account export.

Action Parameters

fields
array
exclude_fields
array
export_id
stringRequired

Action Response

data
object
successful
boolean
error

Get details of a facebook ad.

Action Parameters

fields
array
outreach_id
stringRequired
exclude_fields
array

Action Response

data
object
successful
boolean
error

Pause all emails in a specific classic automation workflow.

Action Parameters

workflow_id
stringRequired

Action Response

data
object
successful
boolean
error

Get information about campaign recipients.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
campaign_id
stringRequired

Action Response

data
object
successful
boolean
error

Get details about a specific abuse report.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
list_id
stringRequired
report_id
stringRequired

Action Response

data
object
successful
boolean
error

Get information about members in a saved segment.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
list_id
stringRequired
segment_id
stringRequired
include_cleaned
boolean
include_transactional
boolean
include_unsubscribed
boolean

Action Response

data
object
successful
boolean
error

Update a file in the file manager.

Action Parameters

file_id
stringRequired
folder_id
integer
name
string

Action Response

data
object
successful
boolean
error

Update a promo code.

Action Parameters

store_id
stringRequired
promo_rule_id
stringRequired
promo_code_id
stringRequired
code
string
redemption_url
string
usage_count
integer
enabled
boolean
created_at_foreign
string
updated_at_foreign
string

Action Response

data
object
successful
boolean
error

Update a specific feedback message for a campaign.

Action Parameters

campaign_id
stringRequired
feedback_id
stringRequired
block_id
integer
message
string
is_complete
boolean

Action Response

data
object
successful
boolean
error

Get reports for surveys.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer

Action Response

data
object
successful
boolean
error

Get information about a store’s products.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
store_id
stringRequired

Action Response

data
object
successful
boolean
error

Add a new member to the list.

Action Parameters

list_id
stringRequired
skip_merge_validation
boolean
tags
array
email_address
stringRequired
email_type
string
status
stringRequired
merge_fields
object
interests
object
language
string
vip
boolean
location__latitude
integer
location__longitude
integer
marketing_permissions
array
ip_signup
string
timestamp_signup
string
ip_opt
string
timestamp_opt
string

Action Response

data
object
successful
boolean
error

Get report for a survey.

Action Parameters

fields
array
exclude_fields
array
survey_id
stringRequired

Action Response

data
object
successful
boolean
error

Update a promo rule.

Action Parameters

store_id
stringRequired
promo_rule_id
stringRequired
title
string
description
string
starts_at
string
ends_at
string
amount
integer
type
string
target
string
enabled
boolean
created_at_foreign
string
updated_at_foreign
string

Action Response

data
object
successful
boolean
error

Add a new promo rule to a store.

Action Parameters

store_id
stringRequired
title
string
description
stringRequired
id
stringRequired
starts_at
string
ends_at
string
amount
integerRequired
type
stringRequired
target
stringRequired
enabled
boolean
created_at_foreign
string
updated_at_foreign
string

Action Response

data
object
successful
boolean
error

Get information about a specific segment.

Action Parameters

fields
array
exclude_fields
array
list_id
stringRequired
segment_id
stringRequired
include_cleaned
boolean
include_transactional
boolean
include_unsubscribed
boolean

Action Response

data
object
successful
boolean
error

Get reports of facebook ads.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
sort_field
string
sort_dir
string

Action Response

data
object
successful
boolean
error

Get a list of reports with child campaigns for a specific parent campaign.

Action Parameters

fields
array
exclude_fields
array
campaign_id
stringRequired

Action Response

data
object
successful
boolean
error

Get events for a contact.

Action Parameters

list_id
stringRequired
subscriber_hash
stringRequired
count
integerDefaults to 10
offset
integer
fields
array
exclude_fields
array

Action Response

data
object
successful
boolean
error

Get report details for a specific sent campaign.

Action Parameters

fields
array
exclude_fields
array
campaign_id
stringRequired

Action Response

data
object
successful
boolean
error

Archive a list member. to permanently delete, use the delete-permanent action.

Action Parameters

list_id
stringRequired
subscriber_hash
stringRequired

Action Response

data
object
successful
boolean
error

Start all emails in a classic automation workflow.

Action Parameters

workflow_id
stringRequired

Action Response

data
object
successful
boolean
error

Get information about all lists in the account.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
before_date_created
string
since_date_created
string
before_campaign_last_sent
string
since_campaign_last_sent
string
email
string
sort_field
string
sort_dir
string
has_ecommerce_store
boolean
include_total_contacts
boolean

Action Response

data
object
successful
boolean
error

Get information about a cart’s line items.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
store_id
stringRequired
cart_id
stringRequired

Action Response

data
object
successful
boolean
error

Create a new folder in the file manager.

Action Parameters

name
stringRequired

Action Response

data
object
successful
boolean
error

Get information about members who have unsubscribed from a specific campaign.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
campaign_id
stringRequired

Action Response

data
object
successful
boolean
error

Get all campaigns in an account.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
type
string
status
string
before_send_time
string
since_send_time
string
before_create_time
string
since_create_time
string
list_id
string
folder_id
string
member_id
string
sort_field
string
sort_dir
string
include_resend_shortcut_eligibility
boolean

Action Response

data
object
successful
boolean
error

Get a summary of the emails in a classic automation workflow.

Action Parameters

workflow_id
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a specific product.

Action Parameters

fields
array
exclude_fields
array
store_id
stringRequired
product_id
stringRequired

Action Response

data
object
successful
boolean
error

Get the the html and plain-text content for a campaign.

Action Parameters

fields
array
exclude_fields
array
campaign_id
stringRequired

Action Response

data
object
successful
boolean
error

Search for list members. this search can be restricted to a specific list, or can be used to search across all lists in an account.

Action Parameters

fields
array
exclude_fields
array
query
stringRequired
list_id
string

Action Response

data
object
successful
boolean
error

Get information about a specific list member, including a currently subscribed, unsubscribed, or bounced member.

Action Parameters

fields
array
exclude_fields
array
list_id
stringRequired
subscriber_hash
stringRequired

Action Response

data
object
successful
boolean
error

Get information about all available segments for a specific list.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
list_id
stringRequired
type
string
since_created_at
string
before_created_at
string
include_cleaned
boolean
include_transactional
boolean
include_unsubscribed
boolean
since_updated_at
string
before_updated_at
string

Action Response

data
object
successful
boolean
error

Update a product image.

Action Parameters

store_id
stringRequired
product_id
stringRequired
image_id
stringRequired
id
string
url
string
variant_ids
array

Action Response

data
object
successful
boolean
error

Get a list of the top email clients based on user-agent strings.

Action Parameters

fields
array
exclude_fields
array
list_id
stringRequired

Action Response

data
object
successful
boolean
error

Get breakdown of product activity for a campaign

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
campaign_id
stringRequired
sort_field
string

Action Response

data
object
successful
boolean
error

Create a new segment in a specific list.

Action Parameters

list_id
stringRequired
name
stringRequired
static_segment
array
options__match
string
options__conditions
array

Action Response

data
object
successful
boolean
error

Get a list of an account’s available templates.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
created_by
string
since_date_created
string
before_date_created
string
type
string
category
string
folder_id
string
sort_field
string
content_type
string
sort_dir
string

Action Response

data
object
successful
boolean
error

Create a new template folder.

Action Parameters

name
stringRequired

Action Response

data
object
successful
boolean
error

Search for tags on a list by name. if no name is provided, will return all tags on the list.

Action Parameters

list_id
stringRequired
name
string

Action Response

data
object
successful
boolean
error

Get information about all stores in the account.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer

Action Response

data
object
successful
boolean
error

Delete a specific order line item.

Action Parameters

store_id
stringRequired
order_id
stringRequired
line_id
stringRequired

Action Response

data
object
successful
boolean
error

Get all of the sending domains on the account.

Action Parameters

Action Response

data
object
successful
boolean
error

Get a list of member’s subscriber activity in a specific campaign.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
campaign_id
stringRequired
since
string

Action Response

data
object
successful
boolean
error

Delete a specific interest category.

Action Parameters

list_id
stringRequired
interest_category_id
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a specific promo code.

Action Parameters

fields
array
exclude_fields
array
store_id
stringRequired
promo_rule_id
stringRequired
promo_code_id
stringRequired

Action Response

data
object
successful
boolean
error

Get the last 50 events of a member’s activity on a specific list, including opens, clicks, and unsubscribes.

Action Parameters

list_id
stringRequired
subscriber_hash
stringRequired
fields
array
exclude_fields
array
action
array

Action Response

data
object
successful
boolean
error

Delete a customer from a store.

Action Parameters

store_id
stringRequired
customer_id
stringRequired

Action Response

data
object
successful
boolean
error

Get a list of an account’s registered, connected applications.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer

Action Response

data
object
successful
boolean
error

Get information about a specific file in the file manager.

Action Parameters

fields
array
exclude_fields
array
file_id
stringRequired

Action Response

data
object
successful
boolean
error

Get detailed information about any campaign emails that were opened by a list member.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
campaign_id
stringRequired
since
string
sort_field
string
sort_dir
string

Action Response

data
object
successful
boolean
error

Get campaign reports.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
type
string
before_send_time
string
since_send_time
string

Action Response

data
object
successful
boolean
error

Replicate a campaign in saved or send status.

Action Parameters

campaign_id
stringRequired

Action Response

data
object
successful
boolean
error

Delete a list from your mailchimp account. if you delete a list, you’ll lose the list history—including subscriber activity, unsubscribes, complaints, and bounces. you’ll also lose subscribers’ email addresses, unless you exported and backed up your list.

Action Parameters

list_id
stringRequired

Action Response

data
object
successful
boolean
error

Add a new order to a store.

Action Parameters

store_id
stringRequired
id
stringRequired
customer__id
string
customer__email__address
string
customer__opt__in__status
boolean
customer__company
string
customer__first__name
string
customer__last__name
string
customer__address__address1
string
customer__address__address2
string
customer__address__city
string
customer__address__province
string
customer__address__province__code
string
customer__address__postal__code
string
customer__address__country
string
customer__address__country__code
string
campaign_id
string
landing_site
string
financial_status
string
fulfillment_status
string
currency_code
stringRequired
order_total
integerRequired
order_url
string
discount_total
integer
tax_total
integer
shipping_total
integer
tracking_code
string
processed_at_foreign
string
cancelled_at_foreign
string
updated_at_foreign
string
shipping__address__name
string
shipping__address__address1
string
shipping__address__address2
string
shipping__address__city
string
shipping__address__province
string
shipping__address__province__code
string
shipping__address__postal__code
string
shipping__address__country
string
shipping__address__country__code
string
shipping__address__longitude
integer
shipping__address__latitude
integer
shipping__address__phone
string
shipping__address__company
string
billing__address__name
string
billing__address__address1
string
billing__address__address2
string
billing__address__city
string
billing__address__province
string
billing__address__province__code
string
billing__address__postal__code
string
billing__address__country
string
billing__address__country__code
string
billing__address__longitude
integer
billing__address__latitude
integer
billing__address__phone
string
billing__address__company
string
promos
array
lines
arrayRequired
outreach__id
string
tracking_number
string
tracking_carrier
string
tracking_url
string

Action Response

data
object
successful
boolean
error

Delete a landing page.

Action Parameters

page_id
stringRequired

Action Response

data
object
successful
boolean
error

Get information about all webhooks for a specific list.

Action Parameters

list_id
stringRequired

Action Response

data
object
successful
boolean
error

Batch subscribe or unsubscribe list members.

Action Parameters

list_id
stringRequired
skip_merge_validation
boolean
skip_duplicate_check
boolean
members
arrayRequired
sync_tags
boolean
update_existing
boolean

Action Response

data
object
successful
boolean
error

Delete a store. deleting a store will also delete any associated subresources, including customers, orders, products, and carts.

Action Parameters

store_id
stringRequired

Action Response

data
object
successful
boolean
error

Add a member to a static segment.

Action Parameters

list_id
stringRequired
segment_id
stringRequired
email_address
stringRequired

Action Response

data
object
successful
boolean
error

Create a new interest or ‘group name’ for a specific category.

Action Parameters

list_id
stringRequired
interest_category_id
stringRequired
name
stringRequired
display_order
integer

Action Response

data
object
successful
boolean
error

Legacy “conversations” endpoint is deprecated; use “inbox” for new messages. old conversations are accessible, but new campaign replies and inbox messages are not.

Action Parameters

fields
array
exclude_fields
array
conversation_id
stringRequired
is_read
string
before_timestamp
string
since_timestamp
string

Action Response

data
object
successful
boolean
error

Update the name, html, or folder id of an existing template.

Action Parameters

template_id
stringRequired
name
stringRequired
folder_id
string
html
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a classic automation email queue.

Action Parameters

workflow_id
stringRequired
workflow_email_id
stringRequired

Action Response

data
object
successful
boolean
error

Create a new webhook for a specific list.

Action Parameters

list_id
stringRequired
url
string
events__subscribe
boolean
events__unsubscribe
boolean
events__profile
boolean
events__cleaned
boolean
events__upemail
boolean
events__campaign
boolean
sources__user
boolean
sources__admin
boolean
sources__api
boolean

Action Response

data
object
successful
boolean
error

Get information about a list’s interest categories.

Action Parameters

list_id
stringRequired
fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
type
string

Action Response

data
object
successful
boolean
error

Stops 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.

Action Parameters

batch_id
stringRequired

Action Response

data
object
successful
boolean
error

Search all campaigns for the specified query terms.

Action Parameters

fields
array
exclude_fields
array
query
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a product’s variants.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
store_id
stringRequired
product_id
stringRequired

Action Response

data
object
successful
boolean
error

Send a test email.

Action Parameters

campaign_id
stringRequired
test_emails
arrayRequired
send_type
stringRequired

Action Response

data
object
successful
boolean
error

Get a specific feedback message from a campaign.

Action Parameters

fields
array
exclude_fields
array
campaign_id
stringRequired
feedback_id
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a specific interest category.

Action Parameters

list_id
stringRequired
interest_category_id
stringRequired
fields
array
exclude_fields
array

Action Response

data
object
successful
boolean
error

Remove a member from the specified static segment.

Action Parameters

list_id
stringRequired
segment_id
stringRequired
subscriber_hash
stringRequired

Action Response

data
object
successful
boolean
error

Update some or all of the settings for a specific campaign.

Action Parameters

campaign_id
stringRequired
recipients__list__id
string
recipients__segment__opts__saved__segment__id
integer
recipients__segment__opts__prebuilt__segment__id
string
recipients__segment__opts__match
string
recipients__segment__opts__conditions
array
settings__title
string
settings__subject__line
string
settings__preview__text
string
settings__from__name
string
settings__reply__to
string
settings__use__conversation
boolean
settings__to__name
string
settings__folder__id
string
settings__authenticate
boolean
settings__auto__footer
boolean
settings__inline__css
boolean
settings__auto__tweet
boolean
settings__auto__fb__post
array
settings__fb__comments
boolean
settings__template__id
integer
variate__settings__winner__criteria
string
variate__settings__wait__time
integer
variate__settings__test__size
integer
variate__settings__subject__lines
array
variate__settings__send__times
array
variate__settings__from__names
array
variate__settings__reply__to__addresses
array
tracking__opens
boolean
tracking__html__clicks
boolean
tracking__text__clicks
boolean
tracking__goal__tracking
boolean
tracking__ecomm360
boolean
tracking__google__analytics
string
tracking__clicktale
string
tracking__salesforce__campaign
boolean
tracking__salesforce__notes
boolean
tracking__capsule__notes
boolean
rss__opts__feed__url
string
rss__opts__frequency
string
rss__opts__schedule__hour
integer
rss__opts__schedule__daily__send__sunday
boolean
rss__opts__schedule__daily__send__monday
boolean
rss__opts__schedule__daily__send__tuesday
boolean
rss__opts__schedule__daily__send__wednesday
boolean
rss__opts__schedule__daily__send__thursday
boolean
rss__opts__schedule__daily__send__friday
boolean
rss__opts__schedule__daily__send__saturday
boolean
rss__opts__schedule__weekly__send__day
string
rss__opts__schedule__monthly__send__date
integer
rss__opts__constrain__rss__img
boolean
social__card__title
string
social__card__description
string
social__card__image__url
string

Action Response

data
object
successful
boolean
error

Get information about a specific connected site.

Action Parameters

fields
array
exclude_fields
array
connected_site_id
stringRequired

Action Response

data
object
successful
boolean
error

Delete a promo code from a store.

Action Parameters

store_id
stringRequired
promo_rule_id
stringRequired
promo_code_id
stringRequired

Action Response

data
object
successful
boolean
error

Get a list of available images and files stored in the file manager for the account.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
type
string
created_by
string
before_created_at
string
since_created_at
string
sort_field
string
sort_dir
string

Action Response

data
object
successful
boolean
error

Delete a specific template folder, and mark all the templates in the folder as ‘unfiled’.

Action Parameters

folder_id
stringRequired

Action Response

data
object
successful
boolean
error

Get details about a specific survey.

Action Parameters

list_id
stringRequired
survey_id
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a specific folder in the file manager.

Action Parameters

fields
array
exclude_fields
array
folder_id
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a store’s carts.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
store_id
stringRequired

Action Response

data
object
successful
boolean
error

Resume an rss-driven campaign.

Action Parameters

campaign_id
stringRequired

Action Response

data
object
successful
boolean
error

Remove a specific file from the file manager.

Action Parameters

file_id
stringRequired

Action Response

data
object
successful
boolean
error

Get a specific note for a specific list member.

Action Parameters

list_id
stringRequired
subscriber_hash
stringRequired
note_id
stringRequired
fields
array
exclude_fields
array

Action Response

data
object
successful
boolean
error

Update a specific folder used to organize templates.

Action Parameters

folder_id
stringRequired
name
stringRequired

Action Response

data
object
successful
boolean
error

Update a specific folder used to organize campaigns.

Action Parameters

folder_id
stringRequired
name
stringRequired

Action Response

data
object
successful
boolean
error

Get information about clicks on specific links in your mailchimp campaigns.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
campaign_id
stringRequired
sort_field
string
sort_dir
string

Action Response

data
object
successful
boolean
error

Update a webhook that will fire whenever any batch request completes processing.

Action Parameters

batch_webhook_id
stringRequired
url
string
enabled
boolean

Action Response

data
object
successful
boolean
error

Get all connected sites in an account.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer

Action Response

data
object
successful
boolean
error

Get reports of landing pages.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer

Action Response

data
object
successful
boolean
error

Get information about a specific order.

Action Parameters

fields
array
exclude_fields
array
store_id
stringRequired
order_id
stringRequired

Action Response

data
object
successful
boolean
error

Get responses to a survey.

Action Parameters

fields
array
exclude_fields
array
survey_id
stringRequired
answered_question
integer
chose_answer
string
respondent_familiarity_is
string

Action Response

data
object
successful
boolean
error

Pause an rss-driven campaign.

Action Parameters

campaign_id
stringRequired

Action Response

data
object
successful
boolean
error

Remove a subscriber from any point in a classic automation workflow; once removed, they cannot be re-added to that workflow.

Action Parameters

workflow_id
stringRequired
email_address
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a specific list in your mailchimp account. results include list members who have signed up but haven’t confirmed their subscription yet and unsubscribed or cleaned.

Action Parameters

fields
array
exclude_fields
array
list_id
stringRequired
include_total_contacts
boolean

Action Response

data
object
successful
boolean
error

Create a new list in your mailchimp account.

Action Parameters

name
stringRequired
contact__company
string
contact__address1
string
contact__address2
string
contact__city
string
contact__state
string
contact__zip
string
contact__country
string
contact__phone
string
permission_reminder
stringRequired
use_archive_bar
boolean
campaign__defaults__from__name
string
campaign__defaults__from__email
string
campaign__defaults__subject
string
campaign__defaults__language
string
notify_on_subscribe
stringDefaults to False
notify_on_unsubscribe
stringDefaults to False
email_type_option
booleanRequired
double_optin
boolean
marketing_permissions
boolean

Action Response

data
object
successful
boolean
error

Get interests or ‘group names’ for a specific category.

Action Parameters

list_id
stringRequired
interest_category_id
stringRequired
interest_id
stringRequired
fields
array
exclude_fields
array

Action Response

data
object
successful
boolean
error

Unpublish a landing page that is in draft or has been published.

Action Parameters

page_id
stringRequired

Action Response

data
object
successful
boolean
error

Add or update a customer.

Action Parameters

store_id
stringRequired
customer_id
stringRequired
id
stringRequired
email_address
stringRequired
opt_in_status
booleanRequired
company
string
first_name
string
last_name
string
address__address1
string
address__address2
string
address__city
string
address__province
string
address__province__code
string
address__postal__code
string
address__country
string
address__country__code
string

Action Response

data
object
successful
boolean
error

Get top open locations for a specific campaign.

Action Parameters

fields
array
exclude_fields
array
campaign_id
stringRequired
count
integerDefaults to 10
offset
integer

Action Response

data
object
successful
boolean
error

Get a summary of batch requests that have been made.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer

Action Response

data
object
successful
boolean
error

Add a new line item to an existing order.

Action Parameters

store_id
stringRequired
order_id
stringRequired
id
stringRequired
product_id
stringRequired
product_variant_id
stringRequired
quantity
integerRequired
price
integerRequired
discount
integer

Action Response

data
object
successful
boolean
error

Pause an automated email.

Action Parameters

workflow_id
stringRequired
workflow_email_id
stringRequired

Action Response

data
object
successful
boolean
error

Manually add a subscriber to a workflow, bypassing the default trigger settings. you can also use this endpoint to trigger a series of automated emails in an api 3.0 workflow type.

Action Parameters

workflow_id
stringRequired
workflow_email_id
stringRequired
email_address
stringRequired

Action Response

data
object
successful
boolean
error

Publish a survey that is in draft, unpublished, or has been previously published and edited.

Action Parameters

list_id
stringRequired
survey_id
stringRequired

Action Response

data
object
successful
boolean
error

Get breakdown of product activity for an outreach.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
outreach_id
stringRequired
sort_field
string

Action Response

data
object
successful
boolean
error

Get a summary of an individual classic automation workflow’s settings and content. the trigger settings object returns information for the first email in the workflow.

Action Parameters

fields
array
exclude_fields
array
workflow_id
stringRequired

Action Response

data
object
successful
boolean
error

Get the status of a batch request.

Action Parameters

fields
array
exclude_fields
array
batch_id
stringRequired

Action Response

data
object
successful
boolean
error

Begin processing a batch operations request.

Action Parameters

operations
arrayRequired

Action Response

data
object
successful
boolean
error

Delete a specific folder in the file manager.

Action Parameters

folder_id
stringRequired

Action Response

data
object
successful
boolean
error

Add a new product to a store.

Action Parameters

store_id
stringRequired
title
stringRequired
description
string
id
stringRequired
handle
string
url
string
type
string
vendor
string
image_url
string
variants
arrayRequired
images
array
published_at_foreign
string

Action Response

data
object
successful
boolean
error

Add a new store to your mailchimp account.

Action Parameters

id
stringRequired
list_id
stringRequired
name
stringRequired
platform
string
domain
string
is_syncing
boolean
email_address
string
currency_code
stringRequired
money_format
string
primary_locale
string
timezone
string
phone
string
address__address1
string
address__address2
string
address__city
string
address__province
string
address__province__code
string
address__postal__code
string
address__country
string
address__country__code
string
address__longitude
integer
address__latitude
integer

Action Response

data
object
successful
boolean
error

A health check for the api that won’t return any account-specific information.

Action Parameters

Action Response

data
object
successful
boolean
error

Utilize the list id and survey id to generate a campaign that links to your survey.

Action Parameters

list_id
stringRequired
survey_id
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a specific subscriber in a classic automation email queue.

Action Parameters

workflow_id
stringRequired
workflow_email_id
stringRequired
subscriber_hash
stringRequired

Action Response

data
object
successful
boolean
error

Add a new variant to the product.

Action Parameters

store_id
stringRequired
product_id
stringRequired
title
stringRequired
id
stringRequired
url
string
sku
string
price
integer
inventory_quantity
integer
image_url
string
backorders
string
visibility
string

Action Response

data
object
successful
boolean
error

List 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.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
has_unread_messages
string
list_id
string
campaign_id
string

Action Response

data
object
successful
boolean
error

Get recent notes for a specific list member.

Action Parameters

list_id
stringRequired
subscriber_hash
stringRequired
sort_field
string
sort_dir
string
fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer

Action Response

data
object
successful
boolean
error

Remove the guesswork for resending a campaign to certain segments. you can use this endpoint as a shortcut to replicate a campaign and resend it to common segments, such as those who didn’t open the campaign, or any new subscribers since it was sent.

Action Parameters

campaign_id
stringRequired
shortcut_type
string

Action Response

data
object
successful
boolean
error

Update the settings for an existing webhook.

Action Parameters

list_id
stringRequired
webhook_id
stringRequired
url
string
events__subscribe
boolean
events__unsubscribe
boolean
events__profile
boolean
events__cleaned
boolean
events__upemail
boolean
events__campaign
boolean
sources__user
boolean
sources__admin
boolean
sources__api
boolean

Action Response

data
object
successful
boolean
error

Get reports for survey questions.

Action Parameters

fields
array
exclude_fields
array
survey_id
stringRequired

Action Response

data
object
successful
boolean
error

Delete a cart.

Action Parameters

store_id
stringRequired
cart_id
stringRequired

Action Response

data
object
successful
boolean
error

Create a new mailchimp campaign.

Action Parameters

type
stringRequired
recipients__list__id
string
recipients__segment__opts__saved__segment__id
integer
recipients__segment__opts__match
string
recipients__segment__opts__conditions
array
settings__title
string
settings__subject__line
string
settings__preview__text
string
settings__from__name
string
settings__reply__to
string
settings__use__conversation
boolean
settings__to__name
string
settings__folder__id
string
settings__authenticate
boolean
settings__auto__footer
boolean
settings__inline__css
boolean
settings__auto__tweet
boolean
settings__auto__fb__post
array
settings__fb__comments
boolean
settings__template__id
integer
variate__settings__winner__criteria
string
variate__settings__wait__time
integer
variate__settings__test__size
integer
variate__settings__subject__lines
array
variate__settings__send__times
array
variate__settings__from__names
array
variate__settings__reply__to__addresses
array
tracking__opens
boolean
tracking__html__clicks
boolean
tracking__text__clicks
boolean
tracking__goal__tracking
boolean
tracking__ecomm360
boolean
tracking__google__analytics
string
tracking__clicktale
string
tracking__salesforce__campaign
boolean
tracking__salesforce__notes
boolean
tracking__capsule__notes
boolean
rss__opts__feed__url
string
rss__opts__frequency
string
rss__opts__schedule__hour
integer
rss__opts__schedule__daily__send__sunday
boolean
rss__opts__schedule__daily__send__monday
boolean
rss__opts__schedule__daily__send__tuesday
boolean
rss__opts__schedule__daily__send__wednesday
boolean
rss__opts__schedule__daily__send__thursday
boolean
rss__opts__schedule__daily__send__friday
boolean
rss__opts__schedule__daily__send__saturday
boolean
rss__opts__schedule__weekly__send__day
string
rss__opts__schedule__monthly__send__date
integer
rss__opts__constrain__rss__img
boolean
social__card__title
string
social__card__description
string
social__card__image__url
string
content_type
string

Action Response

data
object
successful
boolean
error

Delete a specific merge field.

Action Parameters

list_id
stringRequired
merge_id
stringRequired

Action Response

data
object
successful
boolean
error

Delete a verified domain from the account.

Action Parameters

domain_name
stringRequired

Action Response

data
object
successful
boolean
error

Unpublish a survey that has been published.

Action Parameters

list_id
stringRequired
survey_id
stringRequired

Action Response

data
object
successful
boolean
error

Get information about members in a specific mailchimp list.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
list_id
stringRequired
email_type
string
status
string
since_timestamp_opt
string
before_timestamp_opt
string
since_last_changed
string
before_last_changed
string
unique_email_id
string
vip_only
boolean
interest_category_id
string
interest_ids
string
interest_match
string
sort_field
string
sort_dir
string
since_last_campaign
boolean
unsubscribed_since
string

Action Response

data
object
successful
boolean
error

Update a specific interest category.

Action Parameters

list_id
stringRequired
interest_category_id
stringRequired
title
stringRequired
display_order
integer
type
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a specific campaign.

Action Parameters

fields
array
exclude_fields
array
campaign_id
stringRequired
include_resend_shortcut_eligibility
boolean

Action Response

data
object
successful
boolean
error

Get information about a specific product image.

Action Parameters

fields
array
exclude_fields
array
store_id
stringRequired
product_id
stringRequired
image_id
stringRequired

Action Response

data
object
successful
boolean
error

Update a specific order line item.

Action Parameters

store_id
stringRequired
order_id
stringRequired
line_id
stringRequired
product_id
string
product_variant_id
string
quantity
integer
price
integer
discount
integer

Action Response

data
object
successful
boolean
error

Get information about all available surveys for a specific list.

Action Parameters

list_id
stringRequired

Action Response

data
object
successful
boolean
error

Remove a connected site from your mailchimp account.

Action Parameters

connected_site_id
stringRequired

Action Response

data
object
successful
boolean
error

Get a list of abuse complaints for a specific campaign.

Action Parameters

fields
array
exclude_fields
array
campaign_id
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a product’s images.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
store_id
stringRequired
product_id
stringRequired

Action Response

data
object
successful
boolean
error

Add feedback on a specific campaign.

Action Parameters

campaign_id
stringRequired
block_id
integer
message
stringRequired
is_complete
boolean

Action Response

data
object
successful
boolean
error

Get information about an account’s orders.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
campaign_id
string
outreach_id
string
customer_id
string
has_outreach
boolean

Action Response

data
object
successful
boolean
error

Get the locations (countries) that the list’s subscribers have been tagged to based on geocoding their ip address.

Action Parameters

fields
array
exclude_fields
array
list_id
stringRequired

Action Response

data
object
successful
boolean
error

Get report for a survey question.

Action Parameters

fields
array
exclude_fields
array
survey_id
stringRequired
question_id
stringRequired

Action Response

data
object
successful
boolean
error

Update a specific product.

Action Parameters

store_id
stringRequired
product_id
stringRequired
title
string
description
string
handle
string
url
string
type
string
vendor
string
image_url
string
variants
array
images
array
published_at_foreign
string

Action Response

data
object
successful
boolean
error

Add an event for a list member.

Action Parameters

list_id
stringRequired
subscriber_hash
stringRequired
name
stringRequired
properties
object
is_syncing
boolean
occurred_at
string

Action Response

data
object
successful
boolean
error

Get information about subscribers who were removed from a classic automation workflow.

Action Parameters

workflow_id
stringRequired

Action Response

data
object
successful
boolean
error

Get report of a facebook ad.

Action Parameters

fields
array
outreach_id
stringRequired
exclude_fields
array

Action Response

data
object
successful
boolean
error

Get information about a specific promo rule.

Action Parameters

fields
array
exclude_fields
array
store_id
stringRequired
promo_rule_id
stringRequired

Action Response

data
object
successful
boolean
error

Get team feedback while you’re working together on a mailchimp campaign.

Action Parameters

fields
array
exclude_fields
array
campaign_id
stringRequired

Action Response

data
object
successful
boolean
error

Review the send checklist for a campaign, and resolve any issues before sending.

Action Parameters

fields
array
exclude_fields
array
campaign_id
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a specific cart.

Action Parameters

fields
array
exclude_fields
array
store_id
stringRequired
cart_id
stringRequired

Action Response

data
object
successful
boolean
error

Get information about a specific campaign recipient.

Action Parameters

fields
array
exclude_fields
array
campaign_id
stringRequired
subscriber_hash
stringRequired

Action Response

data
object
successful
boolean
error

Get all abuse reports for a specific list.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
list_id
stringRequired

Action Response

data
object
successful
boolean
error

Get a list of available images and files stored in this folder.

Action Parameters

folder_id
stringRequired
fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
type
string
created_by
string
before_created_at
string
since_created_at
string
sort_field
string
sort_dir
string

Action Response

data
object
successful
boolean
error

Get up to the previous 180 days of daily detailed aggregated activity stats for a list, not including automation activity.

Action Parameters

count
integerDefaults to 10
offset
integer
fields
array
exclude_fields
array
list_id
stringRequired

Action Response

data
object
successful
boolean
error

Delete a product image.

Action Parameters

store_id
stringRequired
product_id
stringRequired
image_id
stringRequired

Action Response

data
object
successful
boolean
error

Get a specific list member’s activity in a campaign including opens, clicks, and bounces.

Action Parameters

fields
array
exclude_fields
array
campaign_id
stringRequired
subscriber_hash
stringRequired
since
string

Action Response

data
object
successful
boolean
error

Create a new interest category.

Action Parameters

list_id
stringRequired
title
stringRequired
display_order
integer
type
stringRequired

Action Response

data
object
successful
boolean
error

Get statistics for the top-performing email domains in a campaign.

Action Parameters

fields
array
exclude_fields
array
campaign_id
stringRequired

Action Response

data
object
successful
boolean
error

Update the settings for a specific list.

Action Parameters

list_id
stringRequired
name
stringRequired
contact__company
string
contact__address1
string
contact__address2
string
contact__city
string
contact__state
string
contact__zip
string
contact__country
string
contact__phone
string
permission_reminder
stringRequired
use_archive_bar
boolean
campaign__defaults__from__name
string
campaign__defaults__from__email
string
campaign__defaults__subject
string
campaign__defaults__language
string
notify_on_subscribe
stringDefaults to False
notify_on_unsubscribe
stringDefaults to False
email_type_option
booleanRequired
double_optin
boolean
marketing_permissions
boolean

Action Response

data
object
successful
boolean
error

Unschedule a scheduled campaign that hasn’t started sending.

Action Parameters

campaign_id
stringRequired

Action Response

data
object
successful
boolean
error

Create a new account export in your mailchimp account.

Action Parameters

include_stages
arrayRequired
since_timestamp
string

Action Response

data
object
successful
boolean
error

Get the sections that you can edit in a template, including each section’s default content.

Action Parameters

fields
array
exclude_fields
array
template_id
stringRequired

Action Response

data
object
successful
boolean
error

Remove a specific feedback message for a campaign.

Action Parameters

campaign_id
stringRequired
feedback_id
stringRequired

Action Response

data
object
successful
boolean
error

Update information for a specific list member.

Action Parameters

list_id
stringRequired
subscriber_hash
stringRequired
skip_merge_validation
boolean
email_address
string
email_type
string
status
string
merge_fields
object
interests
object
language
string
vip
boolean
location__latitude
integer
location__longitude
integer
marketing_permissions
array
ip_signup
string
timestamp_signup
string
ip_opt
string
timestamp_opt
string

Action Response

data
object
successful
boolean
error

Delete interests or group names in a specific category.

Action Parameters

list_id
stringRequired
interest_category_id
stringRequired
interest_id
stringRequired

Action Response

data
object
successful
boolean
error

Get a summary of social activity for the campaign, tracked by eepurl.

Action Parameters

fields
array
exclude_fields
array
campaign_id
stringRequired

Action Response

data
object
successful
boolean
error

Create a new classic automation in your mailchimp account.

Action Parameters

recipients__list__id
string
recipients__store__id
string
settings__from__name
string
settings__reply__to
string
trigger__settings__workflow__type
string

Action Response

data
object
successful
boolean
error

Batch add/remove list members to static segment

Action Parameters

list_id
stringRequired
segment_id
stringRequired
members_to_add
array
members_to_remove
array

Action Response

data
object
successful
boolean
error

Removes an individual classic automation workflow email. emails from certain workflow types, including the abandoned cart email (abandonedcart) and product retargeting email (abandonedbrowse) workflows, cannot be deleted.

Action Parameters

workflow_id
stringRequired
workflow_email_id
stringRequired

Action Response

data
object
successful
boolean
error

Delete a specific segment in a list.

Action Parameters

list_id
stringRequired
segment_id
stringRequired

Action Response

data
object
successful
boolean
error

Update a specific note for a specific list member.

Action Parameters

list_id
stringRequired
subscriber_hash
stringRequired
note_id
stringRequired
note
string

Action Response

data
object
successful
boolean
error

Create a new mailchimp landing page.

Action Parameters

use_default_list
boolean
title
string
description
string
name
string
store_id
string
list_id
string
type
string
template_id
integer
tracking__track__with__mailchimp
boolean
tracking__enable__restricted__data__processing
boolean

Action Response

data
object
successful
boolean
error

Verify that the connected sites script has been installed, either via the script url or fragment.

Action Parameters

connected_site_id
stringRequired

Action Response

data
object
successful
boolean
error

Get list of facebook ads.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
sort_field
string
sort_dir
string

Action Response

data
object
successful
boolean
error

Publish a landing page that is in draft, unpublished, or has been previously published and edited.

Action Parameters

page_id
stringRequired

Action Response

data
object
successful
boolean
error

Get links to all other resources available in the api.

Action Parameters

fields
array
exclude_fields
array

Action Response

data
object
successful
boolean
error

Delete a promo rule from a store.

Action Parameters

store_id
stringRequired
promo_rule_id
stringRequired

Action Response

data
object
successful
boolean
error

Add or remove tags from a list member. if a tag that does not exist is passed in and set as ‘active’, a new tag will be created.

Action Parameters

list_id
stringRequired
subscriber_hash
stringRequired
tags
arrayRequired
is_syncing
boolean

Action Response

data
object
successful
boolean
error

Update settings for a classic automation workflow email. only works with workflows of type: abandonedbrowse, abandonedcart, emailfollowup, or singlewelcome.

Action Parameters

workflow_id
stringRequired
workflow_email_id
stringRequired
settings__title
string
settings__subject__line
string
settings__preview__text
string
settings__from__name
string
settings__reply__to
string
delay__amount
integer
delay__type
string
delay__direction
string
delay__action
string

Action Response

data
object
successful
boolean
error

Get all folders used to organize campaigns.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer

Action Response

data
object
successful
boolean
error

Start an automated email.

Action Parameters

workflow_id
stringRequired
workflow_email_id
stringRequired

Action Response

data
object
successful
boolean
error

Get report of a landing page.

Action Parameters

fields
array
outreach_id
stringRequired
exclude_fields
array

Action Response

data
object
successful
boolean
error

Get the details for a single domain on the account.

Action Parameters

domain_name
stringRequired

Action Response

data
object
successful
boolean
error

Add or update a product variant.

Action Parameters

store_id
stringRequired
product_id
stringRequired
variant_id
stringRequired
title
stringRequired
id
stringRequired
url
string
sku
string
price
integer
inventory_quantity
integer
image_url
string
backorders
string
visibility
string

Action Response

data
object
successful
boolean
error

Update a landing page.

Action Parameters

page_id
stringRequired
title
string
description
string
name
string
store_id
string
list_id
string
tracking__track__with__mailchimp
boolean
tracking__enable__restricted__data__processing
boolean

Action Response

data
object
successful
boolean
error

Get information about a specific subscriber who opened a campaign.

Action Parameters

fields
array
exclude_fields
array
campaign_id
stringRequired
subscriber_hash
stringRequired

Action Response

data
object
successful
boolean
error

Add a new customer to a store.

Action Parameters

store_id
stringRequired
id
stringRequired
email_address
stringRequired
opt_in_status
booleanRequired
company
string
first_name
string
last_name
string
address__address1
string
address__address2
string
address__city
string
address__province
string
address__province__code
string
address__postal__code
string
address__country
string
address__country__code
string

Action Response

data
object
successful
boolean
error

Delete a specific cart line item.

Action Parameters

store_id
stringRequired
cart_id
stringRequired
line_id
stringRequired

Action Response

data
object
successful
boolean
error

Delete a specific campaign folder, and mark all the campaigns in the folder as ‘unfiled’.

Action Parameters

folder_id
stringRequired

Action Response

data
object
successful
boolean
error

Get a month-by-month summary of a specific list’s growth activity.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer
list_id
stringRequired
sort_field
string
sort_dir
string

Action Response

data
object
successful
boolean
error

The conversation endpoint is outdated and replaced by inbox, which isn’t supported by it. historical conversation data is accessible, but new replies and inbox messages are not.

Action Parameters

fields
array
exclude_fields
array
conversation_id
stringRequired
message_id
stringRequired

Action Response

data
object
successful
boolean
error

Get a list of account exports for a given account.

Action Parameters

fields
array
exclude_fields
array
count
integerDefaults to 10
offset
integer

Action Response

data
object
successful
boolean
error

Delete a specific note for a specific list member.

Action Parameters

list_id
stringRequired
subscriber_hash
stringRequired
note_id
stringRequired

Action Response

data
object
successful
boolean
error

Get all landing pages.

Action Parameters

sort_dir
string
sort_field
string
fields
array
exclude_fields
array
count
integerDefaults to 10

Action Response

data
object
successful
boolean
error