Learn Mokapen

Facebook Ads

The Facebook Ads integration connects your Facebook/Meta advertising account to Mokapen to sync campaigns and leads: you automatically import campaign performance (spend, impressions, clicks, registrations) and turn the contacts collected with Lead Ads forms into contacts in your CRM, in real time and with no manual exports.

It's an inbound integration: data is brought from Facebook into Mokapen (Mokapen doesn't modify your campaigns on Facebook).

General integrations overview: Integrations.

Requirements

• An active Facebook/Meta Ads account with access to the advertising account and to the Pages you collect leads from.
• A Mokapen plan that includes the Facebook Ads integration (Premium — medal icon on the page if not available on your plan).
• The Marketing → Campaigns module and the faster sync frequencies (hourly/daily) are included in higher Premium plans: if they're not active on your plan, the medal icon appears on the page.

Connecting the Facebook Ads account

1. User menu → Integrations → Facebook Ads.
2. Click Connect to Facebook Ads (requires an adequate Premium plan).
3. Sign in with your Facebook account and grant the requested permissions (reading ads, retrieving leads, managing Pages).
4. When you return you'll see the Connected account status; the connection confirmation appears.
5. Select the advertising account (or accounts) to sync.

Only the user who made the connection can change settings, select Pages and forms, sync, or disconnect the integration for the organization.

Syncing campaigns

Enable campaign syncing to import the advertising structure and metrics:

• Choose which campaigns to sync with the Active campaigns, Inactive campaigns filter or both (select at least one filter before syncing).
• Mokapen imports campaigns, adsets and ads.
• For each ad the daily metrics are synced: spend, impressions, clicks and actions such as completed registrations (conversions). The total spend is reported on the campaign.
• On the first connection the historical data is also imported; then syncing continues automatically.

The automatic sync rules provide that, on scheduled runs, only active campaigns (with their active adsets and ads) and their KPI data are synced. Paused or stopped campaigns aren't updated on the schedule.

Capturing leads from forms

With Facebook Lead Ads forms you can import the collected contacts directly into Mokapen:

1. Enable lead syncing, select the Facebook Page and the forms you want to sync.
2. Map the fields of each form to the contact fields of your CRM (Belongs to menu). The email field is mapped automatically and required: a lead without an email isn't imported.
3. Choose the mode: New & Recent Leads (new leads plus those from the last 90 days) or New Leads.
4. Save or sync: the leads become contacts, attributed to the campaign of origin.

After setup, every new form submission arrives in Mokapen in real time; manual syncing instead retrieves the history according to the chosen mode.

Frequency and options

• Sync frequency — choose how often to update the data. The hourly and daily frequencies are included in higher Premium plans; with lower plans the periodic sync is weekly.
• Avoid duplicates — Mokapen compares the leads' email with existing contacts to avoid creating duplicates (on by default).
• Manage conflicts — decide which app prevails when the same data differs: either Mokapen or Facebook Ads can win.
• Privacy — set the visibility of imported data: public (all members) or private (only selected members).

Where you see the data

• Marketing → Campaigns — the list of campaigns, adsets and ads imported from Facebook Ads, with source, status, number of leads and metrics (spend, impressions, clicks). The module is included in higher Premium plans.
• Reports → Campaigns — charts on campaigns by source, leads by source and leads by campaign, with trends for spend, impressions, clicks and conversions.
• Contacts — imported leads appear as contacts, with the source linked to the campaign that generated them.

Automations

There's no specific trigger for campaigns, but the contacts created from leads of Facebook Ads can start contact-based automations, for example Contact Created or Contact Created or Modified (running automations requires an adequate Premium plan). This way you can immediately send a welcome email or assign the new lead to a salesperson.

Limits to know

• Inbound sync — data goes from Facebook to Mokapen; campaigns on Facebook aren't modified.
• A single manager — only the user who connected the account can manage settings, accounts, Pages and syncing.
• Email required for leads — leads without an email address are ignored.
• Campaign filter required — to sync campaigns you must select at least the Active or Inactive status.
• Campaigns module on a higher plan — the integration connects with an adequate Premium plan; the view in Marketing → Campaigns is included in higher Premium plans.
• Connection to renew periodically — for security reasons, access to Facebook data expires after a certain period: when the connection is about to expire or has expired, Mokapen notifies you and you need to reconnect the account.

Common issues

• Connection expired or session changed — if you see the warning "Your Facebook Ads access token is no longer valid due to a session change or security update. Please reconnect your account to resume syncing." click Reconnect Facebook to resume syncing.
• Permissions updated — if Mokapen reports that the Facebook permissions have changed, reconnect the account to continue without interruptions.
• Campaign sync won't start — check that you've selected at least one campaign filter (Active or Inactive).
• A lead didn't arrive — check that the Page and the form are selected and that the lead has an email; leads without an email aren't imported.
• No form found — if the Page has no lead forms, it's deselected and the related warning appears.
• I don't see the campaigns — make sure your plan includes the Marketing → Campaigns module and that syncing has been started.

Disconnecting

From the Integrations → Facebook Ads page click Disconnect: the DISCONNECT Facebook Ads window opens with the Keep section.

• You can choose to keep the Campaigns already synced: if you leave the option on, campaigns, adsets and ads stay visible in Mokapen; otherwise they're removed along with their metrics.
• You can disconnect a single advertising account or the entire integration.
• The contacts created from leads are not deleted when disconnecting.

To confirm, type DISCONNECT in the required field.

Use cases

• Real-time leads in the CRM — a user fills in a Lead Ads form: the contact arrives in Mokapen right away, ready for sales follow-up.
• Ad spend control — track campaign spend, impressions, clicks and registrations in Marketing → Campaigns without opening Meta's Ads Manager.
• Channel comparison — in Reports → Campaigns you compare the leads generated by Facebook Ads with those from other sources to optimize the budget.
• Automatic follow-up — link an automation to the Contact Created trigger to respond immediately to new leads from Facebook.
• Campaign attribution — each lead keeps the campaign source, so you know which ad brought in the contact.

Frequently asked questions

Q: What is synced from Facebook Ads?

A: Campaigns with adsets and ads, the daily metrics (spend, impressions, clicks, completed registrations) and the leads from Lead Ads forms, which become contacts in the CRM.

Q: Does Mokapen modify my campaigns on Facebook?

A: No. The integration is read-only: it brings data from Facebook to Mokapen, without touching the campaigns.

Q: What plan do I need?

A: An adequate Premium plan to connect the account. The Marketing → Campaigns module and the faster sync frequencies (hourly/daily) are included in higher Premium plans. If a feature isn't available on your plan, the medal icon appears on the page.

Q: Do leads arrive immediately?

A: Yes. After setup, new form submissions arrive in real time; manual syncing retrieves the history (new and recent from the last 90 days, or new only).

Q: Why do I have to reconnect the account periodically?

A: For security reasons, access to Facebook data expires after a certain period. Mokapen warns you when the connection is about to expire or has expired: just click Reconnect Facebook.

Q: What happens to the data if I disconnect?

A: You can choose whether to keep the synced campaigns. The contacts created from leads stay in Mokapen anyway.

Q: Why are some leads not imported?

A: Because they don't have an email address (required) or because the Page/form wasn't selected in the lead sync configuration.

Q: Can I trigger automations on Facebook Ads leads?

A: Yes, via the contact triggers (Contact Created / Contact Created or Modified). Running automations requires an adequate Premium plan.