---
title: Meta Ads Integration | Flyweel Docs
description: Connect Meta Ads (Facebook and Instagram) to Flyweel for unified campaign analysis. Complete setup guide with step-by-step instructions.
url: "https://www.flyweel.co/docs/integrations/meta-ads"
type: static
generatedAt: "2026-10-08T05:30:40.124Z"
---

![Documentation hero background](https://astro-flyweel-docs.vercel.app/vision-hero.webp)
# Meta Ads Integration

## What is Meta Ads Integration?[Link to this section](#what-is-meta-ads-integration)

Meta Ads integration connects your Facebook and Instagram advertising accounts to Flyweel for unified campaign analysis. Import data from all Meta placements including Feed, Stories, Reels, and Audience Network to analyze performance alongside your other advertising platforms.

**Read-Only Access**: Flyweel only requests read permissions. We cannot modify your campaigns, change budgets, or make purchases on your behalf.

## Prerequisites[Link to this section](#prerequisites)

Before connecting Meta Ads to Flyweel, ensure you have:

 - A Meta Business Manager account with admin access
 - Active ad accounts with campaign data
 - A Facebook profile with business permissions

## How Do I Connect Meta Ads to Flyweel?[Link to this section](#how-do-i-connect-meta-ads-to-flyweel)

Connecting Meta Ads takes under 5 minutes using OAuth authentication.

### Navigate to Connections

Go to **Settings > Integrations** in your Flyweel dashboard

### Start Meta Ads Connection

Click the **Connect Meta Ads** button to begin the OAuth flow

### Authorize in Facebook

You will be redirected to Facebook’s authentication system:

 - Log in with your Facebook profile
 - Review Flyweel’s permission requests
 - Grant access to your Meta Ads accounts and campaign data

### Select Ad Accounts

After authorization, select which ad accounts to import into Flyweel

### Save and Sync

Click **Save & Refresh** to begin data synchronization

## Understanding Account Structure[Link to this section](#understanding-account-structure)

Meta Ads accounts are organized through Business Manager:

| Structure Level | Description |
| --- | --- |
| **Business Manager** | Top-level container for all business assets |
| **Ad Accounts** | Individual advertising accounts with campaigns |
| **Campaigns** | Groups of ad sets with specific objectives |
| **Ad Sets** | Targeting and budget configurations |

**Multiple Accounts**: You can connect all ad accounts you have access to through Business Manager. Select relevant accounts for comprehensive cross-account analysis.

## Account Selection Best Practices[Link to this section](#account-selection-best-practices)

When choosing which accounts to connect:

 - **Select relevant accounts**: Choose accounts you actively manage
 - **Consider permissions**: Ensure you have appropriate access level
 - **Review periodically**: Add new accounts as your advertising expands
 - **Start with priorities**: Begin with highest-spending accounts for immediate value

## Data Synchronization[Link to this section](#data-synchronization)

### Initial Sync[Link to this section](#initial-sync)

After selecting accounts:

 1. Click **Save & Refresh** to confirm your selections
 1. Initial data synchronization begins automatically
 1. Import includes historical data (up to 90 days)
 1. Typical sync duration is 2-15 minutes depending on account size

### Ongoing Sync[Link to this section](#ongoing-sync)

 - **Data Refresh**: Every 4 hours from Meta Ads
 - **Historical Data**: Up to 2 years of performance history available

## What Data Does Flyweel Import?[Link to this section](#what-data-does-flyweel-import)

Flyweel imports comprehensive campaign data from Meta Ads:

### Campaign Data[Link to this section](#campaign-data)

 - Campaign names, status, and objectives
 - Budget and scheduling information
 - Campaign type and optimization goals

### Performance Metrics[Link to this section](#performance-metrics)

 - Impressions, reach, and frequency
 - Clicks, conversions, and actions
 - Cost per result metrics
 - Return on ad spend (ROAS)

### Placement Data[Link to this section](#placement-data)

 - Performance by placement (Feed, Stories, Reels, etc.)
 - Device breakdown (mobile, desktop)
 - Platform breakdown (Facebook, Instagram, Audience Network)

### Account Information[Link to this section](#account-information)

 - Account structure and hierarchy
 - Currency and timezone settings
 - Account status indicators

## What Flyweel Cannot Access[Link to this section](#what-flyweel-cannot-access)

For your security, Flyweel cannot:

 - Modify campaigns or ad sets
 - Change budgets or bids
 - Create or delete ads
 - Access billing or payment information
 - Post content to your pages

## Supported Placements[Link to this section](#supported-placements)

Meta Ads integration supports all placements:

 - **Facebook Feed**: In-feed ads on Facebook
 - **Instagram Feed**: In-feed ads on Instagram
 - **Stories**: Full-screen vertical ads on Facebook and Instagram Stories
 - **Reels**: Short-form video ads on Facebook and Instagram Reels
 - **Messenger**: Ads in Messenger inbox and conversations
 - **Audience Network**: Ads on partner apps and websites

## Xero Invoice Sync[Link to this section](#xero-invoice-sync)

Meta Ads accounts can also sync invoices to Xero for automated accounting. This Premium Feature:

 - Creates invoices in Xero for Meta Ads spend
 - Allows per-account sync control
 - Eliminates manual invoice entry

**Premium Feature**: Xero Invoice Sync requires a paid Flyweel plan. See the [Xero Invoice Sync Guide](/docs/integrations/xero-sync) for setup instructions.

## Troubleshooting Common Issues[Link to this section](#troubleshooting-common-issues)

### Authentication Failures[Link to this section](#authentication-failures)

If you cannot connect:

 1. Use the Facebook profile with Business Manager access
 1. Ensure you are not using a personal account without business permissions
 1. Check if your Facebook account is restricted
 1. Clear browser cache and try reconnecting

### Permission Errors[Link to this section](#permission-errors)

If you see permission errors:

 1. Verify admin access in Meta Business Manager
 1. Check ad account ownership or permissions
 1. Contact your agency if using managed accounts
 1. Request appropriate access from account owners

### Missing Accounts[Link to this section](#missing-accounts)

If accounts do not appear:

 1. Confirm the ad account is active and has recent spend
 1. Check Business Manager account assignments
 1. Verify the account is not suspended or restricted
 1. Wait a few minutes and refresh the page

### Data Sync Delays[Link to this section](#data-sync-delays)

If data is not syncing as expected:

 1. Check the last sync time in your dashboard
 1. Verify the account is active in Business Manager
 1. Large accounts may take longer for initial sync
 1. Contact support if sync exceeds expected timeframe

## Disconnecting Meta Ads[Link to this section](#disconnecting-meta-ads)

To disconnect Meta Ads from Flyweel:

 1. Navigate to **Settings > Integrations**
 1. Find Meta Ads in your connected accounts
 1. Click **Disconnect**
 1. Confirm the disconnection

**Data Retention**: Historical performance data remains in Flyweel after disconnecting. Only new data synchronization stops.

## Frequently Asked Questions[Link to this section](#frequently-asked-questions)

### How do I connect Meta Ads to Flyweel?[Link to this section](#how-do-i-connect-meta-ads-to-flyweel-1)

Navigate to Settings > Integrations in Flyweel, click Connect Meta Ads, and complete the OAuth authorization through Facebook. The process takes under 5 minutes.

### What is the difference between Meta Ads, Facebook Ads, and Instagram Ads?[Link to this section](#what-is-the-difference-between-meta-ads-facebook-ads-and-instagram-ads)

Meta Ads is the unified platform that includes both Facebook Ads and Instagram Ads. When you connect Meta Ads, you get data from all Meta placements including Facebook, Instagram, Messenger, and Audience Network.

### What permissions does Flyweel require?[Link to this section](#what-permissions-does-flyweel-require)

Flyweel only requests read-only access to view campaign performance data. We cannot modify campaigns, change budgets, or post content.

### How often does data sync from Meta Ads?[Link to this section](#how-often-does-data-sync-from-meta-ads)

Data refreshes every 4 hours. Historical data is available for up to 2 years.

### Can I connect multiple Meta ad accounts?[Link to this section](#can-i-connect-multiple-meta-ad-accounts)

Yes. You can connect all ad accounts you have access to through Business Manager.

### Can I sync Meta Ads invoices to Xero?[Link to this section](#can-i-sync-meta-ads-invoices-to-xero)

Yes. Flyweel offers Xero Invoice Sync as a Premium Feature. This automatically creates invoices in Xero for your Meta Ads spend. See the [Xero Invoice Sync Guide](/docs/integrations/xero-sync) for details.

### What happens if I disconnect Meta Ads?[Link to this section](#what-happens-if-i-disconnect-meta-ads)

Disconnecting stops future data synchronization. Your historical performance data remains in Flyweel for reporting and analysis.

## Next Steps[Link to this section](#next-steps)

Once Meta Ads is connected:

 1. **Connect Google Ads**: Add [Google Ads integration](/docs/integrations/google-ads) for cross-platform analysis
 1. **Set Up Xero Sync**: Configure [Xero Invoice Sync](/docs/integrations/xero-sync) for automated accounting
 1. **Explore AdGrid**: Use the [AdGrid Campaign Manager](/docs/features/adgrid-campaign-manager) to analyze campaigns
 1. **Set Up Reports**: Configure [Reports & Analytics](/docs/features/reports-analytics) for automated monitoring

---

**Need Help?** Contact our support team at [team@flyweel.co](mailto:team@flyweel.co) for assistance with Meta Ads integration.

### Ready to get started?

Start optimizing your ad spend today with Flyweel.
  [Start Free](https://signup.flyweel.co/?variant=control)