Connecting Meta Ads
Connect selected Meta ad accounts, report on campaigns and spend, and relate consented website visits to known CRM outcomes.
- Plans
- Every plan. Meta Ads is listed when the workspace uses the Marketing suite, turned on at SettingsWorkspaceSuites.
- Who
- The workspace owner, or a member with Ads management permission. Reporting requires Ads viewing permission.
- What it does today
- Imports campaigns, ad sets, ads and daily performance from selected accounts, with paid acquisition context on known CRM records.
Meta Ads links your workspace to the ad accounts of one Meta business portfolio. Choose which accounts to import, then open Marketing, Ads to compare campaign performance and known CRM outcomes. Lumenbase shows when the authorization expires and asks you to renew it.
- Connect: approve Lumenbase in Meta and pick the ad accounts.
- Select accounts: choose Add accounts and import the accounts you want to report on.
- Review results: open Marketing, Ads for performance and known CRM outcomes.
- Keep it connected: reconnect before the authorization expires.
- Disconnect when you no longer want Lumenbase to hold access.
Before you begin
- A Meta business portfolio with at least one ad account.
- Permission in Meta to give apps access to that business portfolio and its ad accounts.
- In Lumenbase, the workspace owner role, or a role with Ads management permission.
Connect Meta Ads
Open Meta Ads
Go to SettingsWorkspaceIntegrations. Under All integrations, find Meta Ads and click Connect.
Start the Meta login
Under Connection, click Connect. Meta opens in the same tab.
Connection
Approve in Meta
Sign in to Meta, choose the business portfolio and select the ad accounts Lumenbase may read. Lumenbase asks for ad reporting (ads_read) and business access (business_management), and nothing else.
Check the result
Meta sends you back to the Meta Ads page. The badge reads Authorized, with the business id and the expiry date under it. On the Integrations page the row reads Connected.
Connection
Business 104857600123456
Expires Dec 14, 2026
- 1Authorized: The stored authorization is valid
- 2Business: The Meta business portfolio you approved
- 3Expires: The date Meta set. Reconnect before it
What Lumenbase checks before it saves
- Both permissions were granted.
- At least one ad account was shared.
- Meta returned an expiry date, at most about 60 days away.
- You still have Ads management permission when Meta sends you back.
If any check fails, nothing is saved and an earlier connection stays as it was. The page shows the reason. See Troubleshooting below.
Accounts, reporting and tracking
After connecting, choose Add accounts. Select each account you want to import. The account row shows sync progress and its last successful sync. Its Actions menu offers Sync now, Tracking setup and Stop importing; stopping preserves history.
Open MarketingAds. Filter campaigns by provider, account and date. Open a campaign for Performance, Ad sets, Ads, Contacts, Companies and Deals. All lists are paginated. Amounts retain their account currency; compare currencies separately.
Tracking setup provides the account-specific URL parameters. Merge them with existing parameters in Meta. Enable Website tracking and obtain visitor consent. Coverage counts observed tracked sessions, not all Meta clicks. Campaign matching uses the declared account and campaign IDs; a campaign name alone is not a match.
Known Contacts use the existing website identity rules. Company outcomes come through visible known Contacts; Deals use existing first-touch attribution and frozen won amounts. These are CRM outcomes, not Meta platform conversions. The integration adds read-only paid acquisition fields, record modules, scoring fields, Analytics datasets and Lumo queries.
Keep it connected
Meta authorizations expire, and Lumenbase does not renew them in the background. You reconnect by hand.
| Status on the Meta Ads page | When | Integrations page |
|---|---|---|
| Not connected | Nothing is stored | Not connected |
| Authorized | More than 7 days before expiry | Connected |
| Expires soon | In the last 7 days before expiry | Action required |
| Reconnect required | After the expiry date | Action required |
To renew, click Reconnect and approve the same business portfolio in Meta. The new expiry date replaces the old one. The status refreshes every minute while the page is open.
Connection
Business 104857600123456
Expires Oct 20, 2026
Reconnect before expiry to keep Meta access.
Disconnect Meta Ads
On the Meta Ads page, click Disconnect and confirm. Lumenbase deletes the stored authorization and cancels any connection still in progress, so a Meta login that finishes afterwards does not bring it back. Account imports stop; existing reports remain. Raw click identifiers are queued for cleanup, and the page shows when cleanup is pending.
Disconnecting does not remove Lumenbase on the Meta side. To do that too, open Meta Business Settings, then Integrations, Connected apps, and remove Lumenbase.
To also remove imported reports, open Data retention and choose Delete imported Ads data. Cleanup runs in bounded background batches. Reconnection is blocked until deletion completes. This does not delete your independently owned Contacts, Companies or Deals.
Settings
| Setting | Where | Default | Applies to |
|---|---|---|---|
| Meta Ads connection | SettingsWorkspaceIntegrationsMeta Ads | Not connected | Whole workspace |
| Marketing suite | SettingsWorkspaceSuites | Depends on the workspace | Whole workspace |
Limits
- Only selected accounts import. Reports initially cover the last 30 completed days in the account timezone, then refresh every six hours. Older retained history is visible, but older dates are not automatically backfilled.
- Lead forms, audience uploads, conversion uploads and campaign editing are not included. Meta conversions are unavailable in these reports.
- One Meta business portfolio per workspace. It can share several ad accounts.
- No automatic renewal. Reconnect before the expiry date.
- A failed provider read can mark the grant as requiring reconnect. An account access error is shown on that account.
- Disconnect removes access in Lumenbase only, not in Meta.
- Members without Ads management permission cannot change the connection. Ads viewing permission controls reports; existing CRM permissions control which outcomes they can see.
Troubleshooting
Meta Ads is not on the Integrations page
- Check that the Marketing suite is on at Settings, Workspace, Suites.
- Clear the search and category filters on the Integrations page.
Connect is missing
The page says "You need Ads management permission to change this connection." Ask the workspace owner or someone with that permission.
Connecting ends with a message
| Message | What to do |
|---|---|
| No ad accounts were granted. Select an ad account in Meta and reconnect. | Connect again and tick at least one ad account in Meta. |
| Allow ad reporting and business access in Meta, then reconnect. | Connect again and keep both permissions selected. |
| Meta authorization was not completed. Check your app access and try again. | The Meta login was cancelled or refused. Check your access to the business portfolio, then try again. |
| This connection link expired or was already used. Start again. | A login link works once, for ten minutes. Click Connect again. |
| The connection changed. Retry, or disconnect before choosing another business. | You picked a different business portfolio. Pick the original one, or disconnect first. |
| Too many connection attempts. Wait a minute and try again. | A workspace can start five connections a minute. |
| Ads connection setup is incomplete. Contact support. | Contact support. This is a setup problem on our side. |
The page says it could not check the connection
Click Retry. Connect stays disabled until the status loads.
- Meta Ads settings
- SettingsWorkspaceIntegrationsMeta Ads
- Turn on the Marketing suite
- Settings → Workspace → Suites
- Renew access
- Meta Ads → Reconnect
- Remove in Meta
- Meta Business Settings → Integrations → Connected apps
Frequently asked questions
Does Lumenbase import my Meta campaigns, spend or leads?
Selected accounts import campaigns, ad sets, ads and daily spend, impressions and clicks. Consented website tracking can relate campaigns to known CRM records. Lead forms are not imported.
Who can connect Meta Ads?
The workspace owner, or a member with Ads management permission. The workspace also needs the Marketing suite turned on.
Why does Meta Ads say Reconnect required?
The authorization from Meta has expired or was revoked. Click Reconnect and approve the same business portfolio in Meta. Lumenbase does not renew it automatically.
Can I switch the workspace to another Meta business portfolio?
Yes, but not with Reconnect. Disconnect Meta Ads first, then connect again and choose the other business portfolio.
Does disconnecting remove Lumenbase in Meta?
No. Disconnect deletes the access Lumenbase stored. To remove the app in Meta too, open Meta Business Settings, Integrations, Connected apps.
Was this article helpful?
