# Facebook Marketing AI connector guide

Connect Facebook Marketing data to AI agents with Combined. Explore ads insights, campaigns, ads, source setup, MCP access and read-only business queries.

Combined offers 1,125 connectors across catalog sources and connectors generated through desktop automation.

## Connect

1. Open Combined Connected Apps and select Facebook Marketing.
2. Authorize the source and choose the relevant datasets.
3. Complete a first sync, then grant your agent access through the Set up or Access workspace.
4. Discover the actual source schemas before querying.

## Setup reference

- Access Token: optional
- Ad Account ID(s): required in the upstream source schema
- Action Breakdowns Allow Empty: optional
- Ad Statuses: optional
- AdSet Statuses: optional
- Campaign Statuses: optional
- Client Id: optional
- Client Secret: optional
- Authentication: required in the upstream source schema; Authenticate via Facebook Marketing (Oauth) or Service Account Key Authentication
- Access Token: depends on the selected authentication/setup option
- Client ID: depends on the selected authentication/setup option
- Client Secret: depends on the selected authentication/setup option
- Access Token: depends on the selected authentication/setup option
- Custom Insights: optional
- Action Breakdowns: depends on the selected authentication/setup option
- Action Report Time: depends on the selected authentication/setup option
- Breakdowns: depends on the selected authentication/setup option
- End Date: depends on the selected authentication/setup option
- Fields: depends on the selected authentication/setup option
- Include Incrementality: depends on the selected authentication/setup option
- Custom Insights Job Timeout: depends on the selected authentication/setup option
- Custom Insights Lookback Window: depends on the selected authentication/setup option
- Level: depends on the selected authentication/setup option
- Name: depends on the selected authentication/setup option
- Start Date: depends on the selected authentication/setup option
- Time Increment: depends on the selected authentication/setup option
- Time Increment Period: depends on the selected authentication/setup option
- Action breakdowns for the Built-in Ads Insight stream: optional
- End Date: optional
- Fetch Thumbnail Images from Ad Creative: optional
- Include Incrementality: optional
- Insights Job Timeout: optional
- Insights Lookback Window: optional
- Page Size of Requests: optional
- Start Date: optional

## Dataset reference

- ads_insights
- campaigns
- ads
- ad_sets
- ad_creatives
- ads_insights_age_and_gender
- ads_insights_action_type
- custom_conversions
- images
- ads_insights_country
- ads_insights_platform_and_device
- ads_insights_region
- ads_insights_comscore_market
- activities

This is the upstream connector reference, version 6.0.2. Account permissions and sync configuration determine the datasets available in your workspace.

## Agent prompt

Use Combined to analyze my Facebook Marketing data.
List my granted sources, discover the datasets and describe their fields.
Look for datasets corresponding to ads_insights, campaigns, ads, ad_sets, ad_creatives, ads_insights_age_and_gender.
Check the last successful sync and report the available date coverage.
Propose three useful questions based on the fields actually available.
For the question I choose, run read-only SQL over the complete matching dataset.
Use a bounded result; include source names, time window and query receipt.
Ask for a missing join key or metric definition instead of inventing one.

## Links

- Combined: https://www.trycombined.com/
- Setup: https://www.trycombined.com/docs/getting-started/onboarding
- MCP: https://www.trycombined.com/docs/integrations/mcp
- Pricing: https://www.trycombined.com/pricing
- Upstream source reference: https://docs.airbyte.com/integrations/sources/facebook-marketing
- Full guide: https://www.trycombined.com/connectors/facebook-marketing