MailerCloud
Integrations › MailerCloud

MailerCloud Integration

Sync ad leads into MailerCloud contact lists in real time -- triggering your email sequences automatically with every new form submission.

Available Integrations

Connect MailerCloud with 4 lead sources

Start Free Trial No credit card required · 14-day free trial
MailerCloud
Facebook to MailerCloud
Sync leads from Facebook & Instagram Lead Ads to MailerCloud in real time.
Available on all plans
MailerCloud
Google Ads to MailerCloud
Sync leads from Google Ads Lead Form Extensions to MailerCloud in real time.
Available on all plans
MailerCloud
LinkedIn to MailerCloud
Sync leads from LinkedIn Lead Gen Forms to MailerCloud in real time.
Available on all plans
MailerCloud
TikTok to MailerCloud
Sync leads from TikTok Lead Generation to MailerCloud in real time.
Available on all plans
Trusted by
1,000+ businesses
Leads synced
2M+
Integrations
37+
Free trial
14 days, no card

How It Works

1
Connect Your Ad Account
Link your Facebook, Google, LinkedIn, or TikTok ad account to LeadSync in one click.
2
Choose MailerCloud
Select MailerCloud as your destination and authenticate your account.
3
Map Your Fields
Match your lead form fields to MailerCloud and start syncing leads instantly.

How LeadSync Pushes Contacts to MailerCloud

MailerCloud's REST API at cloudapi.mailercloud.com/v1/ uses a single long-lived API key for authentication -- copied from MailerCloud Settings › API Token and pasted into the LeadSync connection. The token travels on every request as the Authorization header, and a new contact is created with a single POST to /contacts.

During setup LeadSync calls POST /lists/search with list_type: 1 (subscriber lists) to enumerate every list on your MailerCloud account, plus POST /tags/search -- paginating through all tag pages so even large MailerCloud accounts return their full tag list. You pick a destination list and any number of tags in the connection settings, and every new lead lands on that list with those tags pre-applied.

Custom Fields Use the _cf_<id> Convention

MailerCloud distinguishes default fields (email, name, phone -- referenced by their semantic field_value like email) from custom fields (referenced by id, prefixed with _cf_). LeadSync calls POST /contact/property/search to pull every property defined on your account, and the mapping screen presents them with the right internal id automatically -- you don't have to think about which fields are default vs. custom.

When a lead arrives, the helper detects the _cf_ prefix on a mapped field, strips it, and writes the value under the custom_fields object on the contact create payload (keyed by the numeric custom field id). Default fields go on the top-level payload directly. The result: every value lands in the right MailerCloud slot regardless of whether it's a default property or a custom one you defined yourself.

Tag Selection at Connection Level

Every MailerCloud connection in LeadSync supports applying one or more tags to every contact it creates. Pick the tags from the connection settings (loaded live from your MailerCloud account) and they're sent on every contacts POST as part of the tags array.

Tags are how MailerCloud drives segmentation, automation triggers, and reporting. A lead landing tagged "Facebook Ads" + "Q2 Campaign" is immediately addressable in MailerCloud's campaign builder, automation triggers ("when contact tagged X..."), and segment definitions -- without any extra steps from your team.

Frequently Asked Questions

Log into MailerCloud, open Settings > API Token, and either copy your existing key or generate a new one. Paste it into LeadSync when you create the MailerCloud connection. LeadSync stores the token encrypted and uses it as the Authorization header on every cloudapi.mailercloud.com request.
In the LeadSync connection settings, the Lists dropdown shows every subscriber list on your MailerCloud account (loaded live via the lists/search endpoint with list_type: 1). Pick the destination and every new lead is added to that list as part of the contact create call. The list_id is included on every payload so contacts land bound to the list immediately.
Yes. The connection settings include a Tags multi-select that lists every tag on your MailerCloud account (LeadSync paginates through all tag pages so even large accounts work). Pick one or more tags, and every lead LeadSync creates lands with those tags pre-applied -- ready for segmentation, automation triggers, or campaign filtering.
LeadSync calls MailerCloud's contact/property/search endpoint to enumerate every property -- both defaults (email, name) and custom fields. Custom fields are presented in the mapping dropdown internally with the _cf_<id> prefix MailerCloud expects, but you just see the human-readable name. Pick the property and LeadSync handles the prefix conversion when constructing the payload.
MailerCloud distinguishes default fields (email, name, phone) from custom fields (referenced by numeric id). LeadSync internally uses a _cf_<id> convention to flag custom fields so the helper writes them into the custom_fields object on the contact payload rather than the top-level. You won't see this prefix in the mapping UI, only in the API logs.
Yes. Build a MailerCloud automation with an "Added to list" or "Tag added" trigger and point it at the list / tag LeadSync writes to. Every new lead enters the automation within seconds. Welcome emails, multi-step nurture sequences, and segment-based branching all run automatically.
MailerCloud upserts contacts by email by default, so a repeat submission updates the existing contact's custom field values and adds them to the destination list and tags if not already present. Your subscriber count and reporting stay accurate; the contact doesn't double-fire your automation either.
Yes. Each LeadSync connection picks its own MailerCloud list and tags, so create separate connections for Facebook and LinkedIn. Facebook leads can land on a paid-social list with a "Facebook Ads" tag while LinkedIn leads land on a B2B list with a "LinkedIn" tag, each driving its own automation flow and reporting.
Yes. LeadSync supports MailerCloud as a destination for Facebook Lead Ads, Instagram Lead Ads, Google Ads lead form extensions, LinkedIn Lead Gen Forms, and TikTok Lead Generation. Each ad source is its own LeadSync connection but they all use the same MailerCloud helper writing to /contacts.

Start Syncing Leads to MailerCloud

Set up your MailerCloud integration in under 60 seconds. Free 14-day trial, no credit card required.

Start Your Free Trial
No credit card required • Set up in 60 seconds • Cancel anytime