Meta Ads
Last updated 2026-06-14
What this unlocks
Connect Meta Ads and Quri reads your Facebook and Instagram ad-account spend, ROAS, and creative-level performance — so it answers questions about your campaigns and alerts you when spend spikes or a winning ad starts to fade. No more living in Ads Manager.
Connect it in Quri
- Open /app/connect in Quri and choose Meta Ads from the list of sources.
- You are redirected to Facebook to authorize Quri — sign in with the account that manages your ad account and approve the request.
- Facebook sends you back to Quri, which lands you on /app/connect/meta/select.
- Pick the ad account (or accounts) you want Quri to read from the discovered list — you do not type an account id.
- Quri stores the grant as encrypted, workspace-scoped credentials and starts the first sync; your Meta Ads metrics appear once it completes.
Get your credentials
- For most sellers there is no provider setup — the redirect uses Quri's own Meta app, so you only approve the grant. The steps below are for an operator standing up their own Meta app.
- Sign in at developers.facebook.com and open the App Dashboard, then create an app of type Business.
- Add the Marketing API product to the app so it can read ad-account insights.
- Set up Facebook Login for Business and create a configuration that requests the ads_read permission; note the Configuration ID it issues — the login dialog is invoked with that config_id rather than a raw scope list.
- Add Quri's OAuth redirect URI to the Login settings, then submit the app for App Review so people outside your own Business Manager can grant access.
Access Quri reads with
- ads_read — read-only access to ad-account campaigns, insights, and creatives. Quri requests nothing that can change or spend on your account.
- When Quri uses a Facebook Login for Business configuration, the permissions are defined by that config_id; the equivalent classic-flow scope is ads_read.
- Meta issues a long-lived (about 60-day) token; Quri refreshes it for you so the connection keeps working.
Troubleshooting
- I authorized Meta but Quri found no ad accounts to pick.
- You need a role on the ad account itself — being an admin of the Page or Business is not enough. Open Business settings in Meta Business Manager, confirm your user is assigned to the ad account, then reconnect at /app/connect.
- The Facebook dialog said the feature is unavailable or showed an error instead of the permission prompt.
- That usually means the Meta app behind the connection has not finished App Review for ads_read, or its Login for Business configuration is misconfigured. For a Quri-hosted connection this is on us; for your own operator app, finish App Review and confirm the config_id requests ads_read.
- My Meta connection worked for weeks and then stopped reading data.
- Meta tokens are long-lived but not permanent, and changing your Facebook password or removing Quri in your Meta app settings revokes them early. Reconnect at /app/connect to issue a fresh token.