--- title: "How to Integrate Mailercloud with Any App Using Zapier" description: "Learn how to connect your Mailercloud account with 6,000+ apps via Zapier. This guide covers v1.3.0 of the integration, which includes 13 actions across Contacts, Tags, and Lists." url: https://help.mailercloud.com/en/articles/51-how-to-integrate-mailercloud-with-any-app-using-zapier collection: "Integrations" updated: 2026-10-21 language: en --- # How to Integrate Mailercloud with Any App Using Zapier Learn how to connect your Mailercloud account with 6,000+ apps via Zapier. This guide covers v1.3.0 of the integration, which includes 13 actions across Contacts, Tags, and Lists. **Note:** This integration provides **actions** (steps a Zap performs in Mailercloud). It does not yet provide triggers — use it as an action step after a trigger from another app. ## Step 1 — Connect Your Mailercloud Account 1. Log in to Mailercloud. 2. Go to **Account → API & Integrations** ([app.mailercloud.com/account/api-integrations](https://app.mailercloud.com/account/api-integrations)). 3. Copy your **API Key**. 4. In Zapier, paste the key into the connection window and click **Yes, Continue**. > **Tip:** Zapier verifies the key instantly. If you see _"The API Key you supplied is invalid"_, re-copy it from the dashboard. You can connect multiple accounts and pick which one each Zap uses. Your key is stored securely and can be revoked anytime in Mailercloud. > > ## Step 2 — Set Up a Trigger (from Another App) 1. Log in to your Zapier account. 2. Click **Create Zap** from the left menu and give your Zap a name. 3. Search for the app you want to use as a trigger (e.g. Google Sheets, Typeform, HubSpot). 4. Connect that app's account and choose a **Trigger Event** (e.g. _New Spreadsheet Row_ in Google Sheets). 5. Set up and test the trigger, then click **Continue**. ## Step 3 — Set Up a Mailercloud Action After setting up your trigger, search for **Mailercloud** as the action app and choose one of the 13 available actions below. ## Contact Actions ### Add Contact to List Adds a new contact to a Mailercloud list.

Field	Required	Notes
List	Yes	Dropdown of your lists (loads newest first).
Email	Yes	The contact's email address.
Contact Type	No	Active, Bounce, Abuse, Unsubscribe, Suppressed, or Spam.
Name, Middle/Last Name, City, Country, Department, Industry, Job Title, Lead Source, Organization, Phone, Salary, State, Zip	No	Standard contact attributes.
Tags	No	Multi-select of existing tags. Tags are additive — they are added on top of existing tags, never replace them.
Custom fields	No	Your Mailercloud custom fields appear automatically. Date fields use a date picker.

> **Tip:** Once you've mapped fields, click **Test Action** to verify data flows correctly, then click **Continue**. ### Update Contact Updates an existing contact matched by Email. Includes the same fields as **Add Contact to List**, except no List field. Only fields you fill in are changed. ### Create or Update Contact (Upsert) _(v1.3.0)_ Creates the contact, or updates it if one with that email already exists — in a single step. No need for separate Add and Update Zaps. The output tells you whether the contact was **created** or **updated**. ### Delete Contact _(v1.3.0)_

Field	Required	Notes
Contact (Email or ID)	Yes	The email address or contact ID to delete.

**Important — Tags on Add / Update / Upsert are append-only.** Tags selected in these actions are added on top of existing tags — they do not remove tags already on the contact. > - To **remove** a tag, use the **Remove Tags From Contact** action. > > - To **only add** tags without touching other fields, use **Add Tags to Contact**. > ## Tag Actions

Action	Required Fields	What it Does
Add Tags to Contact (v1.3.0)	Contact (Email or ID), Tags to Add	Adds one or more existing tags to a contact (additive).
Remove Tags From Contact	Contact (Email or ID), Tags to Remove	Removes one or more tags from a contact.
Create Tag (v1.3.0)	Tag Name	Creates a new tag; returns its ID.
Update Tag (v1.3.0)	Tag, New Tag Name	Renames an existing tag.
Delete Tag (v1.3.0)	Tag	Deletes a tag from your account.

## List Actions

Action	Required Fields	What it Does
Create List (v1.3.0)	List Name	Creates a new contact list; returns its ID.
Update List (v1.3.0)	List, New List Name	Renames an existing list.
Delete List (v1.3.0)	List	Deletes a contact list.

## About Tags 1. **Tags must already exist.** The Tags dropdown lists tags already in your account. Create new ones with the **Create Tag** action or in Mailercloud under **Audience → Tags**. 2. **Adding tags is additive.** Add Contact, Update Contact, Upsert, and Add Tags to Contact all add tags on top of what the contact already has — they never replace existing ones. 3. **To remove a tag,** use **Remove Tags From Contact**. > **Keep tags exactly in sync:** Use two steps — (1) **Remove Tags From Contact** to strip unwanted tags, then (2) **Update Contact** (or **Add Tags**) to add the ones you want. ## About Custom Date Fields If you have a Date-type custom field in Mailercloud, it shows up with a date picker in Zapier. Whatever date format the value arrives in — ISO 8601, a plain date, or a Unix timestamp — it's automatically converted to the format Mailercloud requires (`YYYY-MM-DD`), and the timezone is handled so the calendar day never shifts. Just map your date and run. ## Adding Mailercloud to an Existing Zap Already have Mailercloud connected? There's nothing to reinstall or reconnect — the new actions are available immediately. 1. Open your Zap → **Edit**. 2. Click the Mailercloud step. 3. Pick the action and fill in the fields. 4. Click **Test**, then **Publish**. Your existing API key keeps working. ## Step 4 — Turn On Your Zap Once you've tested your action and confirmed data looks correct, click **Turn On** to activate the Zap. From this point, your chosen action will trigger automatically whenever the source app event occurs. ## Troubleshooting

Message / Symptom	Cause & Fix
"The API Key you supplied is invalid"	Key is wrong or revoked. Reconnect with a fresh key from Account → API & Integrations.
"Tag not found" when adding tags	The tag doesn't exist yet. Create it using the Create Tag action or in Mailercloud, then re-select it.
A date custom field error (e.g. "2006-01-02 format")	Fixed in v1.3.0 — date fields auto-convert. Make sure you're on the current version and the field is mapped to a real date/datetime value.
Can't find a list or tag in the dropdown	Dropdowns load 100 at a time. Click Load more to see further pages, then use the search box to filter. Newest lists load first.
Delete/Update Tag or List does nothing	Make sure you selected the item from the dropdown (these actions need the tag/list ID, which is picked from the list).
Updated tags but old ones remain	Expected behaviour — tag adds are additive. Use Remove Tags From Contact to remove unwanted tags.

## Limits & Notes - **Dropdowns paginate** — accounts with more than 100 lists, tags, or custom fields can load and select all of them using **Load more**. - **Contact matching** is by email (Update/Upsert) or email/ID (tag & delete actions). - **Multi-tenant safe** — every call is scoped to the account behind the connected API key. ## **Need Help?** If you have questions or need assistance at any point, don't hesitate to **reach out to our support team** — we're here to help. **Happy emailing!** 🚀