Meta Ads
Connect Facebook and Instagram ad accounts to Reeve for campaign data, ROAS, and creative performance.
Meta Ads Connector
Connect your Meta Business Suite to pull Facebook and Instagram ad campaign data, spend metrics, ROAS, and audience insights into Reeve.
What You Get
| Data | Examples |
|---|---|
| Campaign performance | Impressions, clicks, CTR, conversions |
| Ad spend | Daily/weekly/monthly spend, budget utilization |
| ROAS | Return on ad spend by campaign and ad set |
| Audience demographics | Age, gender, location breakdowns |
| Creative performance | Which ad creatives are performing best |
| Ad intelligence | Competitor ad library research |
Setup
Navigate to Connectors
In the Cockpit, go to Connectors and find Meta Ads under Advertising. Click Connect.
Authorize on Facebook
You'll be redirected to Facebook's authorization page. Log in with the Facebook account that has access to your ad accounts.
Approve the requested permissions:
ads_management— Read your ad campaigns and performance datapages_read_engagement— Read page data linked to ads
Token Exchange
After authorization, Reeve automatically:
- Exchanges the short-lived token for a long-lived token (~60 days)
- Fetches all accessible ad accounts
- Redirects you back to the Cockpit
Meta Ads shows as Connected with your ad account name.
Meta long-lived tokens last approximately 60 days. Reeve handles refresh automatically. If you see a disconnected state, click Connect again to re-authorize.
Using Meta Ads Data
In the Dashboard
The Meta Ads connector populates the Advertising panel on the Dashboard with:
- Total ad spend vs budget
- ROAS by campaign
- Top-performing ad creatives
- Audience performance breakdown
Via Agent Tools
Your agents use the reeve_ads tool to access Meta Ads data:
// Campaign performance summary
reeve_ads({ action: "get_performance", platform: "meta" })
// Top performing ads
reeve_ads({ action: "get_top_performers", platform: "meta" })
// Ad intelligence — competitor analysis
reeve_ads({ action: "analyze_intelligence", platform: "meta" })
// Competitor ad library search
reeve_ads({ action: "get_competitor_ads", url: "competitor.com" })
// Generate new ad creative
reeve_ads({ action: "generate_ad", prompt: "Summer sale for athletic wear" })
// Generate ad image
reeve_ads({ action: "generate_image", prompt: "Product lifestyle shot", size: "1080x1080" })Example Conversations
Ask your agent:
- "What's our ROAS on Meta this month?"
- "Which ad creatives are converting best?"
- "Show me our competitor's active Facebook ads."
- "Generate 3 ad copy variants for our spring collection."
- "How does our CPA compare to last month?"
Prerequisites
To connect Meta Ads, you need:
- A Facebook Business Account with at least one ad account
- Admin or Advertiser access to the ad account(s) you want to connect
- The Facebook account used to authorize must have access to the ad accounts
If you manage ads through a Business Manager, make sure the Facebook account has been added to the Business Manager with appropriate permissions.
Troubleshooting
| Issue | Solution |
|---|---|
| No ad accounts found | Ensure your Facebook account has access to at least one ad account in Business Manager |
| Token expired | Click Connect again to re-authorize — Reeve will exchange for a new long-lived token |
| Permission denied | You need Admin or Advertiser role on the ad account |
| Data not showing | New connections may take a few minutes for the first data pull |
Disconnecting
- Go to Connectors in the Cockpit
- Hover over the Meta Ads card and click Disconnect
- Credentials are deleted from Reeve
You can also revoke access from Facebook Settings → Business Integrations.