Last updated: 4 July 2026
Meta Ads
BetaQuery Facebook and Instagram ad performance, budgets, and audience data from Meta Ads Manager.
Who needs this: Marketing teams running Meta ad campaigns who want AI to summarise performance and manage budgets.
Example questions once connected
- How much did I spend on ads yesterday?
- What is my cost per click this week?
- Which ad set has the highest ROAS?
- Update the daily budget for the June Promo ad set to KES 5,000
What you need before starting
- A Meta Business Manager account at business.facebook.com
- At least one active or paused ad account in your Business Manager
- Admin or Advertiser role on the ad account you want to connect
⚠️
No developer account needed. Msharti is a registered Meta Business Partner — the connection uses standard Facebook OAuth.
Step-by-step setup
- Open the connector. In your Msharti dashboard, go to Connectors → Meta Ads → Connect and click the Connect with Facebook button.
- Log in with Facebook. Sign in with the Facebook account that manages your Business Manager. Facebook shows a consent screen listing what Msharti can read. Review and click Continue.
- Select your ad accounts. Choose which ad account(s) to grant Msharti access to. You can select multiple accounts.
- Confirm in Msharti. Facebook redirects you back to Msharti. The connector shows Connected and lists the ad accounts linked.
Tool reference
These are the tools the AI can call on this connector. Each tool fires automatically when you ask a relevant question.
campaign_insights() Return performance metrics for one or more ad campaigns over a date range. Inputs optional: campaign_name, date_range, metrics
Try asking "Show me spend, reach, and ROAS for all active campaigns this week"
Returns June Promo: KES 12,400 spent, 48,210 reach, ROAS 3.2x. Brand Awareness: KES 3,100 spent, 92,000 reach.
list_adsets() List ad sets with budget, targeting summary, and current status. Inputs optional: campaign_name, status filter
Try asking "Show me all active ad sets and their daily budgets"
Returns 3 active ad sets: "Nairobi — 25-44" (KES 3,000/day), "Kenya — Broad" (KES 2,000/day), "Retargeting" (KES 500/day).
update_budget() Update the daily or lifetime budget for an ad set. Inputs adset_name or ID, budget_type (daily/lifetime), new_amount
Try asking "Increase the daily budget for "Nairobi — 25-44" to KES 5,000"
Returns Ad set "Nairobi — 25-44" budget updated. Daily budget: KES 5,000. Effective immediately.
Limits
- Facebook OAuth tokens expire every 60 days. Msharti sends a renewal reminder 7 days before expiry.
- Budget updates require Advertiser role on the ad account. Admin role required for billing changes.
- Insights data has a 3-hour reporting lag. Real-time delivery stats are estimates.
Need help? [email protected] — Nairobi-based, same time zone.