# Mailchimp

## How to get up and running with Mailchimp in Mavenseed. 

1. Login with your Mavenseed account at <http://mavenseed.com>. From your Avatar drop-down menu on the top-right of the page, select the name of your site.&#x20;
2. On the left hand side click **Settings** > **Communications**

![](/files/-LaHRMmA-6F_CWwKHvOZ)

* **Site Email:** Appears as the "From:" field on transactional emails.
* **Mailchimp API Key:** Used for subscribing customers to your email newsletter. Once you enter and save the API Key, a new option will appear below to select your preferred email list.
* **Default Email List:** After entering in your API Key, a new option will appear to choose which email list you'd like your customers to subscribe to.&#x20;

{% hint style="info" %}
A [Mailchimp account](http://mailchimp.com) is required to collect email addresses from your customers. Don't fret, we vouch for them and to start off you can roll a free account that will scale when you do. After creating your Mailchimp account, [click here ](https://us19.admin.mailchimp.com/account/api/)to find your API Key.&#x20;
{% endhint %}

### Why would you integrate Mailchimp?&#x20;

The primary reason would be to collect email addresses, tags, and events from your customers. Collecting email addresses happens in a number of different areas on your site:

* Site launch Page
* Product coming soon page
* Newsletter Widget in the page buildersite's launch page or product coming soon page, in addition to tagging subscribers, and powering events. Once you have added your Mailchimp API this email field will appear on coming soon product and your site's [Launch Page](broken://pages/-L_pfcSduIfNb2rUV7Oh).&#x20;

![](/files/-LaHSiPHx4guNTZK2m0C)

### Mailchimp Events

If a customer has consented to your sites [marketing policy](/getting-started-with-mavenseed/account-info/sites/policies.md), and they are logged into your site, then we'll also send the following events to Mailchimp.

<details>

<summary>Started Course</summary>

When a customer completes the first lesson in a course. Includes the additinal data:

* Course Title

</details>

<details>

<summary>Completed Course</summary>

When a customer completes the all lessons in a course. Includes the additinal data:

* Course Title

</details>

<details>

<summary>Viewed Plans</summary>

When a logged in customer views the subscribe page.

</details>

<details>

<summary>Viewed Subscribe</summary>

Similar to viewing plans, but when a plan is selected, and the subscribe page is viewed. Includes the following additional data:

* Plan Title

</details>

<details>

<summary>Subscribed</summary>

When a customer subscribes. Includes the additional data:

* Plan Title

*Note: We also add tags (below) when someone subscribes.*

</details>

### Mailchimp Tags

If you sell subscriptions, we'll automatically tag those customers in your Mailchimp account so that they can easily be segmented.

{% hint style="info" %}
Only customers who have consented to email marketing will be tagged in Mailchimp.
{% endhint %}

The following tags are send to Mailchimp under the below listed conditions:

**Free Signup**

When someone creates a free account they are tagged as <mark style="color:blue;">free</mark>.

**Subscribing**

When a customer completes step one of the signup process, three tags are added:&#x20;

* <mark style="color:blue;">subscriber</mark>
* <mark style="color:blue;">status-pending</mark>
* <mark style="color:blue;">plan-PLANNAME</mark>

At this point the subscription still needs to be paid for by the customer. One they complete signing up, the tag <mark style="color:blue;">status-pending</mark> will be changed to <mark style="color:blue;">status-active</mark>.

If the customer decides to not continue subscribing, and they click "No Thanks" on the Call to Action Modal that pops up if they don't continue subscribing, then the <mark style="color:blue;">status-pending</mark> tag will change to <mark style="color:blue;">status-pending-canceled</mark>

The status is reflective of the subscription status as it changes.&#x20;

For example, if the customer has canceled, they will be tagged with <mark style="color:blue;">subscriber</mark>, <mark style="color:blue;">status-canceled</mark>, <mark style="color:blue;">plan-PLANNAME</mark>. The reason the customer stays tagged with subscriber is so that they can be segmented between <mark style="color:blue;">status-active</mark>, <mark style="color:blue;">status-canceled</mark>, <mark style="color:blue;">status-expired</mark>, or <mark style="color:blue;">status-trialing</mark>.

The <mark style="color:blue;">PLANNAME</mark> uses the id of the Subscription Plan in Stripe or Braintree.&#x20;

For Stripe Plans that do not have a custom ID set, this would be in the form of plan\_xxxxx. For Braintree it would be the name of the plan that you set.


---

# 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://docs.mavenseed.com/managing-your-site/settings/integrations/mailchimp.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.