> For the complete documentation index, see [llms.txt](https://learn.moselle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.moselle.io/getting-started/onboarding/setup-integrations/meta-ads.md).

# Meta Ads (Facebook & Instagram)

{% hint style="info" %}
**Quick Answer:** The Meta Ads integration connects your **Facebook and Instagram ad account** to Moselle in one click. Once connected, Moselle pulls in your advertising activity so Mo can see when campaigns are running alongside your sales — helping explain demand spikes and factor promotions into your forecasts. Setup is self-serve and takes about 5 minutes.
{% endhint %}

{% embed url="<https://youtu.be/r2EemsXheO0>" %}

## What this connection does

The Meta Ads integration links your **Meta (Facebook & Instagram) ad account** to Moselle so your advertising activity sits next to your sales data. This gives Mo the context to answer the question every brand asks: *"This SKU is doing well — is that an ad driving it, or something else?"*

Once connected, Moselle reads your ad account's activity and performance so Mo can:

* **Explain demand spikes** — connect a jump in sales to a campaign that was live at the same time
* **Account for promotions in planning** — recognize when marketing activity is inflating recent demand, so forecasts don't over- or under-react
* **Give fuller answers about performance** — factor advertising alongside sales history when you ask Mo why a product is moving

The connection is **read-only**. Moselle reads your advertising activity — it never creates, edits, pauses, or spends against your ad campaigns.

## What you'll need

* [ ] A **Meta Business** account with access to the ad account you want to connect
* [ ] Permission to authorize third-party apps for that ad account (typically an **admin** on the Business account)

{% hint style="info" %}
**Tip:** Make sure you're logged into the correct Facebook account before you start — the one with access to the ad account you want Moselle to see. If you manage several ad accounts, you'll choose which to grant access to during the authorization step.
{% endhint %}

## Connect Meta Ads

{% stepper %}
{% step %}

### Open the Integrations tab in Moselle

Click your **avatar** in the top right corner → **Settings** → the **Integrations** tab.
{% endstep %}

{% step %}

### Select Meta and click Connect

Find the **Meta** integration in the grid and click **Connect**. Moselle redirects you to Facebook to authorize access.
{% endstep %}

{% step %}

### Authorize access on Facebook

On Facebook, review the requested access and choose the **ad account** you want Moselle to read. Approve the request to return to Moselle.

{% hint style="success" %}
**Connected.** Your advertising activity begins syncing automatically. Mo can start using ad context in its answers once the first sync completes.
{% endhint %}
{% endstep %}
{% endstepper %}

## Reconnecting Meta

You may need to re-authorize the connection — for example, if you switch ad accounts or your access expires. When Meta is already connected, the button changes to **Reconnect**.

1. Go to your **avatar** → **Settings** → **Integrations**
2. Find **Meta** and click **Reconnect**
3. Complete the Facebook authorization again to refresh access

Reconnecting re-authorizes Moselle without removing your existing connection.

## Data Sync Details

**What syncs** — Advertising activity and performance data from the ad account you authorize.

**Sync frequency** — Meta data syncs automatically once connected. Like other Moselle integrations, updates refresh on a daily cycle.

**Where it shows up** — Meta context is used by **Mo** when reasoning about demand. Ask Mo about a product's recent performance and it can factor in whether advertising was running.

## Frequently Asked Questions

### Does connecting Meta let Moselle change my ads?

**No.** The integration is **read-only**. Moselle reads your advertising activity to inform planning — it never creates, edits, pauses, or spends against your campaigns.

### Can I connect Instagram ads too?

**Yes.** Meta ad accounts cover both **Facebook and Instagram** placements. Connecting your Meta ad account brings in activity across both platforms.

### Do you support Google Ads?

Google Ads is **coming soon**. If connecting Google Ads is a priority for your team, email <support@moselle.io> to register your interest.

### How do I disconnect Meta?

You can revoke Moselle's access at any time from your **Meta Business** settings, under connected apps. Reach out to <support@moselle.io> if you'd like help.

***

## Related Guides

{% content-ref url="/pages/iSRNCSGVWQanaAuYnC4i" %}
[Setup Integrations](/getting-started/onboarding/setup-integrations.md)
{% endcontent-ref %}

{% content-ref url="/pages/XeG8X01ydINzo9HZqLlY" %}
[Setting Up Channels](/getting-started/onboarding/setting-up-channels.md)
{% endcontent-ref %}
