Mailchimp Component
Interact with email campaign lists and e-commerce resources.
Component key: mailchimp
Description
Mailchimp is a marketing automation platform and email marketing service. The Mailchimp component allows you to interact with your mailchimp email campaigns and your e-commerce site.
You can configure a Mailchimp webhook to send information to a Prismatic webhook URL under certain conditions ("Profile Updates", "Subscribes", "Campaign Sending", etc.).
For more information on configuring webhooks refer to the Mailchimp Docs
Connections
Mailchimp API Key
This component can be configured to use an API Key to authenticate the request. An API key can be obtained by following Mailchimp's quickstart guide
| Input | Notes | Example |
|---|---|---|
| API Key | Provide a string value for the API Key. | |
| Debug Request | When enabled, the component will log the request and response to the console. | false |
Mailchimp OAuth 2.0 Connection
| Input | Notes | Example |
|---|---|---|
| Authorize URL | The OAuth 2.0 Authorization URL for Mailchimp | https://login.mailchimp.com/oauth2/authorize |
| Client ID | 000000000000 | |
| Client secret | 0123456789abcdef0123456789abcdef0123456789abcdef01 | |
| Debug Request | When enabled, the component will log the request and response to the console. | false |
| Scopes | Mailchimp does not support granular scopes. | |
| Token URL | The OAuth 2.0 Token URL for Mailchimp | https://login.mailchimp.com/oauth2/token |
Actions
Add Customer
Add a new customer to a store | key: addCustomer
| Input | Notes | Example |
|---|---|---|
| Address 1 | Provide a string value that represents the 1st address field. | 4 Privet Drive |
| Address 2 | Provide a string value that represents the 2nd address field. | apt 4 |
| City | Provide a string value that represents the city. | Palo Alto |
| Company | Provide a string value that represents the company. | Example Company inc. |
| Connection | ||
| Country | Provide a string value that represents the country | United States |
| Country Code | Provide a string value that represents the country code | USA |
| Customer Id | Provide a string value that represents the customer Id. | 53ce5example278 |
Provide a string value that represents the email address. | someone@example.com | |
| First Name | Provide a string value that represents a first name. | John |
| Last Name | Provide a string value that represents a last name. | Doe |
| Opt In Status | 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. | true |
| Postal Code | Provide a string value that represents the postal code. | 90210 |
| Province | Provide a string value that represents the province. | British Colombia |
| Province Code | Provide a string value that represents the province code. | BC |
| Store Id | Provide a string value that represents the store Id. | 53ce5example278 |
Add List
Create a new list in your Mailchimp account | key: addList
| Input | Notes | Example |
|---|---|---|
| Address 1 | Provide a string value that represents the 1st address field. | 4 Privet Drive |
| Address 2 | Provide a string value that represents the 2nd address field. | apt 4 |
| City | Provide a string value that represents the city. | Palo Alto |
| Company | Provide a string value that represents the company. | Example Company inc. |
| Connection | ||
| Country | Provide a string value that represents the country | United States |
| Email Type Option | Whether the list supports multiple formats for emails. When set to true, subscribers can choose whether they want to receive HTML or plain-text emails. When set to false, subscribers will receive HTML emails, with a plain-text alternative backup. | false |
| From Email | The 'from' name on the campaign (not an email address). | John.Doe@gmail.com |
| From Name | The default 'from name' for campaigns sent to this list. | John Doe |
| Language | The default language for this lists's forms. | English |
| Marketing Permissions | Whether or not the list has marketing permissions (eg. GDPR) enabled. | false |
| Name | Provide a string value that represents the name of the list. | Example Name |
| Permission reminder | Provide a string value that represents the permission reminder. | This is an example reminder! |
| Phone | Provide a string value that represents phone number | 5556879055 |
| Postal Code | Provide a string value that represents the postal code. | 90210 |
| State | Provide a string value that represents the state. | CA |
| Subject | Provide a string value that represents the subject of the email. | This is an example subject |
Add Member
Add a new member to a list | key: addMember
| Input | Notes | Example |
|---|---|---|
| Connection | ||
Provide a string value that represents the email address. | someone@example.com | |
| Email Type | Type of email this member asked to get ('html' or 'text'). | html |
| Interest | The key of this object's properties is the Id of the interest in question. | |
| Language | The default language for this lists's forms. | English |
| List Id | Provide a string value for the Id of the list. | 53ce5example278 |
| Merge Field | A merge field (audience fields) where the key is the merge tag. For example, {"FNAME":"Freddie"} | |
| Status | Subscriber's current status. Possible values: "subscribed", "unsubscribed", "cleaned", "pending", or "transactional". | subscribed |
| Tags | The tags that are associated with a member. | |
| VIP | Provide a boolean to determine VIP status. | false |
Archive Member
Archive a list member | key: archiveMember
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| List Id | Provide a string value for the Id of the list. | 53ce5example278 |
| SubscriberHash | The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts email addresses. | example23370f6fe20d1b66b686e1dfb8bac5ba |
Delete Cart
Delete a specific cart | key: deleteCart
| Input | Notes | Example |
|---|---|---|
| Cart Id | Provide a string value that represents the cart Id. | 53ce5example278 |
| Connection | ||
| Store Id | Provide a string value that represents the store Id. | 53ce5example278 |
Delete Cart Line Items
Get information about a cart's line items. | key: deleteCartLineItem
| Input | Notes | Example |
|---|---|---|
| Cart Id | Provide a string value that represents the cart Id. | 53ce5example278 |
| Connection | ||
| Line Id | Provide a string value that represents the line Id. | 53ce5example278 |
| Store Id | Provide a string value that represents the store Id. | 53ce5example278 |
Delete Customer
Delete a customer from a store | key: deleteCustomer
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Customer Id | Provide a string value that represents the customer Id. | 53ce5example278 |
| Store Id | Provide a string value that represents the store Id. | 53ce5example278 |
Delete List
Delete a list from your Mailchimp account | key: deleteList
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| List Id | Provide a string value for the Id of the list. | 53ce5example278 |
Delete Member
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 | key: deleteMember
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| List Id | Provide a string value for the Id of the list. | 53ce5example278 |
| SubscriberHash | The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts email addresses. | example23370f6fe20d1b66b686e1dfb8bac5ba |
Delete Order
Delete an order | key: deleteOrder
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Order Id | Provide a string value that represents the order id. | Provide a string value for the id of the order in the store. |
| Store Id | Provide a string value that represents the store Id. | 53ce5example278 |
Delete Order Line Item
Delete an order Line Item | key: deleteOrderLineItem
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Line Id | Provide a string value that represents the line Id. | 53ce5example278 |
| Order Id | Provide a string value that represents the order id. | Provide a string value for the id of the order in the store. |
| Store Id | Provide a string value that represents the store Id. | 53ce5example278 |
Delete Product
Delete a product from a store | key: deleteProduct
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Product Id | Provide a string value that represents the product Id. | 53ce5example278 |
| Store Id | Provide a string value that represents the store Id. | 53ce5example278 |
Get Cart
Get information about a specific cart | key: getCart
| Input | Notes | Example |
|---|---|---|
| Cart Id | Provide a string value that represents the cart Id. | 53ce5example278 |
| Connection | ||
| Store Id | Provide a string value that represents the store Id. | 53ce5example278 |
Get Cart Line Item
Get information about a cart's specific line item | key: getCartLineItem
| Input | Notes | Example |
|---|---|---|
| Cart Id | Provide a string value that represents the cart Id. | 53ce5example278 |
| Connection | ||
| Line Id | Provide a string value that represents the line Id. | 53ce5example278 |
| Store Id | Provide a string value that represents the store Id. | 53ce5example278 |
Get Customer
Get information about a store's specific customer | key: getCustomerInfo
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Customer Id | Provide a string value that represents the customer Id. | 53ce5example278 |
| Store Id | Provide a string value that represents the store Id. | 53ce5example278 |
Get List
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. | key: getList
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| List Id | Provide a string value for the Id of the list. | 53ce5example278 |
Get Lists Info
Get information about all lists in the account | key: getListsInfo
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Result Count | Provide an integer value for the maximum amount of results that will be returned. Provide a value from 1 to 1000. | 20 |
| Offset | Provide an integer value for the page offset for the given object's results. | 3 |
Get Member
Get information about a specific list member, including a currently subscribed, unsubscribed, or bounced member | key: getMember
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| List Id | Provide a string value for the Id of the list. | 53ce5example278 |
| SubscriberHash | The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts email addresses. | example23370f6fe20d1b66b686e1dfb8bac5ba |
Get Order
Get information about a specific order | key: getOrderInfo
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Order Id | Provide a string value that represents the order id. | Provide a string value for the id of the order in the store. |
| Store Id | Provide a string value that represents the store Id. | 53ce5example278 |
Get Order Line Item
Get an order Line Item | key: getOrderLineItem
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Line Id | Provide a string value that represents the line Id. | 53ce5example278 |
| Order Id | Provide a string value that represents the order id. | Provide a string value for the id of the order in the store. |
| Store Id | Provide a string value that represents the store Id. | 53ce5example278 |
Get Product
Get information about a specific product | key: getProductInfo
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Product Id | Provide a string value that represents the product Id. | 53ce5example278 |
| Store Id | Provide a string value that represents the store Id. | 53ce5example278 |
Get Store
Get information about a specific store | key: getStore
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Store Id | Provide a string value that represents the store Id. | 53ce5example278 |
List Account Orders
Get information about an account's orders | key: listAccountOrders
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Result Count | Provide an integer value for the maximum amount of results that will be returned. Provide a value from 1 to 1000. | 20 |
| Offset | Provide an integer value for the page offset for the given object's results. | 3 |
List Campaigns
Get all campaigns in an account | key: listCampaigns
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Result Count | Provide an integer value for the maximum amount of results that will be returned. Provide a value from 1 to 1000. | 20 |
| Offset | Provide an integer value for the page offset for the given object's results. | 3 |
List Cart Line Items
Get information about a cart's line items. | key: listCartLineItem
| Input | Notes | Example |
|---|---|---|
| Cart Id | Provide a string value that represents the cart Id. | 53ce5example278 |
| Connection | ||
| Result Count | Provide an integer value for the maximum amount of results that will be returned. Provide a value from 1 to 1000. | 20 |
| Offset | Provide an integer value for the page offset for the given object's results. | 3 |
| Store Id | Provide a string value that represents the store Id. | 53ce5example278 |
List Carts
Get information about a store's carts | key: listCarts
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Result Count | Provide an integer value for the maximum amount of results that will be returned. Provide a value from 1 to 1000. | 20 |
| Offset | Provide an integer value for the page offset for the given object's results. | 3 |
| Store Id | Provide a string value that represents the store Id. | 53ce5example278 |
List Customers
Get information about a store's customers | key: listCustomers
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Result Count | Provide an integer value for the maximum amount of results that will be returned. Provide a value from 1 to 1000. | 20 |
| Offset | Provide an integer value for the page offset for the given object's results. | 3 |
| Store Id | Provide a string value that represents the store Id. | 53ce5example278 |
List Members
Get information about members in a specific Mailchimp list | key: listMembers
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Result Count | Provide an integer value for the maximum amount of results that will be returned. Provide a value from 1 to 1000. | 20 |
| List Id | Provide a string value for the Id of the list. | 53ce5example278 |
| Offset | Provide an integer value for the page offset for the given object's results. | 3 |
{
"data": {}
}
List Order Line Items
List Order Line items | key: listOrderLineItems
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Result Count | Provide an integer value for the maximum amount of results that will be returned. Provide a value from 1 to 1000. | 20 |
| Offset | Provide an integer value for the page offset for the given object's results. | 3 |
| Order Id | Provide a string value that represents the order id. | Provide a string value for the id of the order in the store. |
| Store Id | Provide a string value that represents the store Id. | 53ce5example278 |
List Orders
List all the orders in a store | key: listOrders
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Result Count | Provide an integer value for the maximum amount of results that will be returned. Provide a value from 1 to 1000. | 20 |
| Offset | Provide an integer value for the page offset for the given object's results. | 3 |
| Store Id | Provide a string value that represents the store Id. | 53ce5example278 |
List Products
List all products from a store | key: listProducts
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Result Count | Provide an integer value for the maximum amount of results that will be returned. Provide a value from 1 to 1000. | 20 |
| Offset | Provide an integer value for the page offset for the given object's results. | 3 |
| Store Id | Provide a string value that represents the store Id. | 53ce5example278 |
List Stores
Get information about all stores in the account | key: listStores
| Input | Notes | Example |
|---|---|---|
| Connection |
Ping
Send a ping to determine the status of the Mailchimp servers | key: ping
| Input | Notes | Example |
|---|---|---|
| Connection |
Raw Request
Send raw HTTP request to Mailchimp | key: rawRequest
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Data | The HTTP body payload to send to the URL. | {"exampleKey": "Example Data"} |
| Debug Request | Enabling this flag will log out the current request. | false |
| File Data | File Data to be sent as a multipart form upload. | [{key: "example.txt", value: "My File Contents"}] |
| File Data File Names | File names to apply to the file data inputs. Keys must match the file data keys above. | |
| Form Data | The Form Data to be sent as a multipart form upload. | [{"key": "Example Key", "value": new Buffer("Hello World")}] |
| Header | A list of headers to send with the request. | User-Agent: curl/7.64.1 |
| Max Retry Count | The maximum number of retries to attempt. Specify 0 for no retries. | 0 |
| Method | The HTTP method to use. | |
| Query Parameter | A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2. | |
| Response Type | The type of data you expect in the response. You can request json, text, or binary data. | json |
| Retry On All Errors | If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors. | false |
| Retry Delay (ms) | The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled. | 0 |
| Timeout | The maximum time that a client will await a response to its request | 2000 |
| URL | Input the path only (/reporting/facebook-ads), The base URL is already included (https://${dc}.api.mailchimp.com/3.0). For example, to connect to https://${dc}.api.mailchimp.com/3.0/reporting/facebook-ads, only /reporting/facebook-ads is entered in this field. | /reporting/facebook-ads |
| Use Exponential Backoff | Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored. | false |
Send Campaign
Send a Mailchimp campaign. For RSS Campaigns, the campaign will send according to its schedule. All other campaigns will send immediately. | key: sendCampaign
| Input | Notes | Example |
|---|---|---|
| Campaign Id | Provide a string value that represents the campaign Id. | 53ce5example278 |
| Connection |
Update Customer
Update a specific customer's information | key: updateCustomer
| Input | Notes | Example |
|---|---|---|
| Address 1 | Provide a string value that represents the 1st address field. | 4 Privet Drive |
| Address 2 | Provide a string value that represents the 2nd address field. | apt 4 |
| City | Provide a string value that represents the city. | Palo Alto |
| Company | Provide a string value that represents the company. | Example Company inc. |
| Connection | ||
| Country | Provide a string value that represents the country | United States |
| Country Code | Provide a string value that represents the country code | USA |
| Customer Id | Provide a string value that represents the customer Id. | 53ce5example278 |
| First Name | Provide a string value that represents a first name. | John |
| Last Name | Provide a string value that represents a last name. | Doe |
| Opt In Status | 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. | true |
| Postal Code | Provide a string value that represents the postal code. | 90210 |
| Province | Provide a string value that represents the province. | British Colombia |
| Province Code | Provide a string value that represents the province code. | BC |
| Store Id | Provide a string value that represents the store Id. | 53ce5example278 |
Update List
Update the information or metadata of a list | key: updateList
| Input | Notes | Example |
|---|---|---|
| Address 1 | Provide a string value that represents the 1st address field. | 4 Privet Drive |
| Address 2 | Provide a string value that represents the 2nd address field. | apt 4 |
| City | Provide a string value that represents the city. | Palo Alto |
| Company | Provide a string value that represents the company. | Example Company inc. |
| Connection | ||
| Country | Provide a string value that represents the country | United States |
| Email Type Option | Whether the list supports multiple formats for emails. When set to true, subscribers can choose whether they want to receive HTML or plain-text emails. When set to false, subscribers will receive HTML emails, with a plain-text alternative backup. | false |
| From Email | The 'from' name on the campaign (not an email address). | John.Doe@gmail.com |
| From Name | The default 'from name' for campaigns sent to this list. | John Doe |
| Language | The default language for this lists's forms. | English |
| List Id | Provide a string value for the Id of the list. | 53ce5example278 |
| Marketing Permissions | Whether or not the list has marketing permissions (eg. GDPR) enabled. | false |
| Name | Provide a string value that represents the name of the list. | Example Name |
| Permission reminder | Provide a string value that represents the permission reminder. | This is an example reminder! |
| Phone | Provide a string value that represents phone number | 5556879055 |
| Postal Code | Provide a string value that represents the postal code. | 90210 |
| State | Provide a string value that represents the state. | CA |
| Subject | Provide a string value that represents the subject of the email. | This is an example subject |
Update Member
Update a specific member in a given list | key: updateMember
| Input | Notes | Example |
|---|---|---|
| Connection | ||
Provide a string value that represents the email address. | someone@example.com | |
| Email Type | Type of email this member asked to get ('html' or 'text'). | html |
| Interest | The key of this object's properties is the Id of the interest in question. | |
| Language | The default language for this lists's forms. | English |
| List Id | Provide a string value for the Id of the list. | 53ce5example278 |
| Marketing Permissions | The marketing permissions for the subscriber. | |
| Merge Field | A merge field (audience fields) where the key is the merge tag. For example, {"FNAME":"Freddie"} | |
| Skip Merge Fields | If Skip Merge Fields is true, member data will be accepted without merge field values, even if the merge field is usually required. This defaults to false. | false |
| Status | Subscriber's current status. Possible values: "subscribed", "unsubscribed", "cleaned", "pending", or "transactional". | subscribed |
| SubscriberHash | The MD5 hash of the lowercase version of the list member's email address. This endpoint also accepts email addresses. | example23370f6fe20d1b66b686e1dfb8bac5ba |
| VIP | Provide a boolean to determine VIP status. | false |