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.
Log in to Mailercloud.
Go to Account → API & Integrations (app.mailercloud.com/account/api-integrations).
Copy your API Key.
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)
Log in to your Zapier account.
Click Create Zap from the left menu and give your Zap a name.
Search for the app you want to use as a trigger (e.g. Google Sheets, Typeform, HubSpot).
Connect that app's account and choose a Trigger Event (e.g. New Spreadsheet Row in Google Sheets).
Set up and test the trigger, then click Continue.
After setting up your trigger, search for Mailercloud as the action app and choose one of the 13 available actions below.
Adds a new contact to a Mailercloud list.
Field | Required | Notes |
List | Yes | Dropdown of your lists (loads newest first). |
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.
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.
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.
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.
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. |
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. |
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.
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.
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.
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.
Already have Mailercloud connected? There's nothing to reinstall or reconnect — the new actions are available immediately.
Open your Zap → Edit.
Click the Mailercloud step.
Pick the action and fill in the fields.
Click Test, then Publish.
Your existing API key keeps working.
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.
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. |
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.
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! 🚀
