Connect Meta ads
Updated November 12, 2026
You connect Meta ads to AdsGuru over OAuth: sign in with a profile that has admin access to the Business Manager owning the ad account, select the ad accounts, and grant the ads_management permission. The first sync pulls about 90 days of history for the baseline audit.
How to connect Meta ads
The connection takes about two minutes:
- In AdsGuru, open Settings, then Connections, then Connect Meta.
- Sign in with a Facebook profile that has admin access to the Business Manager (Business Portfolio) that owns the ad account.
- Select the ad account or accounts AdsGuru should manage.
- Grant the ads_management permission. The first sync starts immediately and pulls about 90 days of history.
The baseline audit lands within the hour, and includes a tracking check on your pixel and Conversions API events, because Meta optimization is only as good as the conversion data feeding it.
What access you need on Meta
You need to be an admin of the Business Manager that owns the ad account, with the ad account assigned to you. Meta layers two permission systems, which is where most connection problems come from: business-level roles and asset-level roles.
| Meta role | Level | Can connect AdsGuru for management |
|---|---|---|
| Business admin | Business Manager | Yes, if the ad account is owned by or shared with this business |
| Business employee | Business Manager | Only for ad accounts specifically assigned to them with manage permissions |
| Ad account admin (full control) | Ad account | Yes, for that ad account |
| Ad account advertiser | Ad account | Usually insufficient for granting third-party management |
| Ad account analyst (view only) | Ad account | No |
If you run ads from a personal ad account with no Business Manager, Meta will prompt you through its flow; a Business Manager is the cleaner long-term setup and takes a few minutes to create at business.facebook.com.
Business Manager hygiene before you connect
Five minutes in Business settings prevents most Meta connection weirdness, and is worth doing annually regardless of any tool:
- Confirm ownership: the ad account should be owned by your Business Manager, not by a departed founder's personal profile. Ownership moves are much easier before access is lost.
- Check your own role: business admin, with the ad account assigned to you with manage permissions. Partner access granted from another business behaves differently than direct assignment, which matters for what you can delegate.
- Two-factor on every admin profile: Meta increasingly requires it, and admin takeovers are the common disaster in this ecosystem.
- Clean the people list: remove ex-employees and old agencies. Each stale admin is an unnecessary risk and a potential source of mystery changes.
- Verify payment method and spending limits: an expiring card or an account spending limit about to be hit stops delivery in ways that look like performance problems.
None of this is AdsGuru-specific; it is the hygiene the connection sits on top of.
What permissions AdsGuru requests
AdsGuru requests the ads_management permission: read campaign structure and performance, and create or edit campaigns, ad sets, ads and budgets, on the ad accounts you selected. That is the complete list of what the grant enables.
It does not include posting to your Page, reading your personal profile or messages, managing Business Manager users, or touching payment methods. Meta shows you the requested permissions on its own consent screen before you approve, so you can verify the scope there rather than taking our word for it. The general security model is covered at security and access.
What syncs after connecting
The first sync pulls about 90 days of history from the selected ad accounts: campaign, ad set and ad structure, spend and results, frequency and delivery data, learning phase status, and the conversion events each ad set optimizes for.
Daily syncs after that pull yesterday's performance and any configuration changes. Everything is read-only until you approve a proposal; approved changes are applied through the Meta Marketing API and logged with before and after values.
The sync also covers the diagnostics the routines depend on: frequency per ad for fatigue detection, learning status for budget moves that avoid resetting it, and delivery errors or rejections for alerts.
Attribution settings sync too: AdsGuru reads which attribution window each campaign reports under and keeps comparisons consistent, because mixing windows is the quietest way to draw wrong conclusions from true numbers.
The pixel and Conversions API check
On connect, AdsGuru audits whether purchase or lead events are actually arriving, because broken tracking is the most expensive silent failure in Meta advertising. Meta optimizes delivery toward the events it sees; if events are missing or doubled, Meta optimizes toward a fiction and your money follows.
The check covers three things. First, that the pixel fires on the conversion points that matter. Second, that Conversions API (CAPI) events, the server-side copies of those events, arrive as well, since browser-only tracking loses a share of conversions to ad blockers and browser privacy features. Third, that pixel and CAPI events deduplicate correctly through matching event IDs, because without deduplication every conversion counts twice and your reported performance is inflated roughly two-to-one.
Findings arrive in the audit with the specific event and the problem named. Tracking fixes are flagged for you or your developer; AdsGuru does not edit your website.
A useful habit even without any tool: open Events Manager monthly and look at the event match quality and deduplication status on your purchase event. Those two readings catch most silent tracking decay before it costs a campaign.
Multiple ad accounts, Pages and catalogs
Select as many ad accounts as the plan covers: the accounts of one business on Pro, or per-client workspaces on Agency. Each connected account is scanned and reported separately.
Pages and catalogs do not need separate connections: ads reference them, and the ads_management grant on the ad account is what AdsGuru operates with. What AdsGuru cannot do is act on assets the ad account itself cannot use, so if an ad account lost access to a Page or catalog, that is a Business Manager assignment to fix at business.facebook.com, and the audit will flag the resulting delivery errors.
Troubleshooting the connection
The ad account does not appear in the picker
The profile you signed in with lacks access to that account. Check Business settings, Accounts, Ad accounts at business.facebook.com and confirm your user is assigned to the account with manage permissions.
Meta asks you to re-authenticate repeatedly
Meta expires third-party tokens when the granting user changes their password, loses a role, or the business triggers a security review. Reconnect from Settings, Connections; it takes a minute and restores the same scoped access.
Performance numbers look different from Ads Manager
Check the attribution window. Meta defaults to 7-day click plus 1-day view, and comparisons against a different window will disagree. AdsGuru reports which window it is reading and keeps it consistent.
A new ad account is missing
Ad accounts created after connection are not auto-added. Add them from Settings, Connections, Edit selection. The same applies to ad accounts newly shared with your Business Manager by a partner.
How to revoke access
Revoke from either side; both take effect immediately:
- From Meta: business.facebook.com, Business settings, Integrations, Connected apps (or your profile's Settings, Apps and websites for personal grants), find AdsGuru, remove.
- From AdsGuru: Settings, Connections, Disconnect next to the Meta connection.
Your campaigns keep running exactly as they are at the moment of disconnection. Synced data is deleted within 30 days, per the data policy. One handover note: tokens die with the granting user's access, so if the person who made the grant leaves the business, make a fresh connection from another admin profile before their roles are removed.
Common questions
What is the AdsGuru Meta connection?
It is an OAuth link between your Meta ad accounts and AdsGuru, scoped to ads_management, that lets AdsGuru read performance daily and apply the changes you approve on Facebook and Instagram campaigns.
Do I need a Business Manager?
It is the clean way: admin access to the Business Manager owning the ad account, with the account assigned to you. Personal ad accounts can connect through Meta's flow, but a Business Manager is worth setting up.
Does AdsGuru get access to my Facebook Page or messages?
No. The grant is ads_management on the selected ad accounts only: no posting, no messages, no profile data, no user management, no payment methods.
Why does AdsGuru check my pixel and CAPI?
Because Meta optimizes toward the conversion events it receives. Missing or duplicated events mean the platform, and any tool reading it, optimizes toward wrong numbers. The connect-time audit verifies events arrive and deduplicate.
Will connecting reset my learning phase?
No. Connecting is read-only and changes nothing about delivery. Later changes you approve are sized to avoid unnecessary learning phase resets where possible.
How do I disconnect?
Remove AdsGuru under Business settings, Integrations at business.facebook.com, or disconnect in AdsGuru under Settings, Connections. Either kills access immediately.
Which Meta campaign types are supported?
The standard buying types Ads Manager runs, including Advantage+ shopping campaigns. AdsGuru works with the structure you have rather than forcing a rebuild; see account structure.
What happens when my Meta token expires?
Delivery and campaigns are unaffected; only AdsGuru's syncing pauses. Reconnect from Settings, Connections in about a minute, and the sync catches up from where it stopped.