# MailChimp Contact Action

Use this action to update or add a contact to any give MailChimp list. You can specify any merge-fields you have created on MailChimp for the list.

![](/files/-Lg3O33q0Afeoc-p0aiQ)

### Settings

The action uses the following settings:

| Setting       | Description                                                               | [Parsed](/actions-and-operations/dynamic-parsing.md) |
| ------------- | ------------------------------------------------------------------------- | ---------------------------------------------------- |
| API Key       | The API Key you can copy and paste from you Mailchimp account information | :white\_check\_mark:                                 |
| List Id       | The id of the Mailchimp list that will be targeted by this action         | :white\_check\_mark:                                 |
| Email Address | The email address of the contact that will be added to the list           | :white\_check\_mark:                                 |
| Merge Fields  | The merge fields you would like to populate on the target contact         | :white\_check\_mark:                                 |

### Remarks

This action is always used in conjunction with [contact variables parsing](/actions-and-operations/dynamic-parsing.md), usually to add a marketing contact found with your chatbot to your own mailing list. A typical fields setup would be something like the picture below:

![](/files/-Lg3PGLFLoToAZLXcPgY)

Both API Key and List Id must be retrieved from your mailchimp account. You should find them following these steps:

*API Key*\
From the left main menu, click on your Username, then select "Account" in the flyout menu. From the account page select "Extras", "API Keys". Your API Key will be listed in the table labeled "Your API Keys". 

*List ID*\
When viewing your MailChimp Lists, select the list you want to target, then click "Settings" and then "List name & defaults". Your list id will be at the top of the right column.

### Trigger

This action has no triggers.

### Variables

This action does not produce any variable.

### Availability

Channel specific availability follows the table below:

| Channel          | Availability     |
| ---------------- | ---------------- |
| Facebook         | Fully Available. |
| WhatsApp         | Fully Available. |
| Telegram         | Fully Available. |
| Web              | Fully Available. |
| Alexa            | Fully Available. |
| Google Assistant | Fully Available. |
| Slack            | Fully Available. |
| API              | Fully Available. |

This action can be used only inside interactions and not as child of other actions. Like all integrations, this action is available only to [Premium users](/basic-concepts/your-account/the-free-plan.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs10.xenioo.com/actions-and-operations/integration/xenioo.bots.actions.base.integrations.mailchimplistaction.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.