> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upstackdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Connect your Facebook Ads Account in Upstack Data Integrations

> Connect your Facebook Ads account to Upstack Data so spend, impressions, and clicks pull into the dashboard for unified channel-level ROAS and attribution reporting.

<Tip>
  * Sign in to Upstack Data at [app.upstackdata.com](https://app.upstackdata.com) and navigate to **Data Integrations**.
  * On the **Facebook ads** card, open the **kebab menu** (3 dots) → click **Connect**.
  * Authorize with Facebook and select the **ad account** you want to connect.
  * Click **Save** and verify the integration shows **Healthy**.
</Tip>

<Note>
  **Purpose of this setup**

  Connecting your Facebook ads account is required to access performance data at the account, campaign, ad set, and ad levels, which powers your dashboards and attribution reporting.
</Note>

## Prerequisites

Before you start, you need:

* An active Upstack Data account ([sign up](https://app.upstackdata.com))
* Admin or advertiser access to the **Facebook ad account** you want to connect
* A Facebook user account that can sign in via OAuth on this browser

## Configuration steps

<Steps>
  <Step title="Sign in to Upstack Data">
    Sign in to Upstack Data at [app.upstackdata.com](https://app.upstackdata.com), then navigate to **Data Integrations** in the left-hand menu (or open it directly at [app.upstackdata.com/pixel/integrations](https://app.upstackdata.com/pixel/integrations)).

    <img src="https://mintcdn.com/upstackdata-afbed50d/40dgTTn1PLjePhJa/images/intercom/e928558b597cf5e1.jpg?fit=max&auto=format&n=40dgTTn1PLjePhJa&q=85&s=9be65a434d2b73ae85b1c103046ea2d5" alt="Upstack dashboard with Data Integrations menu option" width="1828" height="1880" data-path="images/intercom/e928558b597cf5e1.jpg" />
  </Step>

  <Step title="Open the Facebook ads connector">
    On the **Data Integrations** page, find the **Facebook ads** card and click the **kebab menu** (3 dots) in the top-right of the card, then click **Connect**.

    <img src="https://mintcdn.com/upstackdata-afbed50d/a7q81tQDxtvowAUn/images/intercom/1449ce0c05a69caf.jpg?fit=max&auto=format&n=a7q81tQDxtvowAUn&q=85&s=1cd19494c9ef3cc0c5c725d5c6c930ca" alt="Facebook ads card with kebab menu showing Connect option" width="1828" height="1880" data-path="images/intercom/1449ce0c05a69caf.jpg" />

    If the Facebook account shown is correct, click **Connect** or **Reconnect**.

    <img src="https://mintcdn.com/upstackdata-afbed50d/a7q81tQDxtvowAUn/images/intercom/1268da1b9bc4416e.png?fit=max&auto=format&n=a7q81tQDxtvowAUn&q=85&s=5f82520d39803447edff7563c640eb75" alt="Facebook account confirmation with Connect button" width="1819" height="1544" data-path="images/intercom/1268da1b9bc4416e.png" />

    If the Facebook account shown is **not** the one that has access to your ad account, click **Log into another account**.

    <img src="https://mintcdn.com/upstackdata-afbed50d/a7q81tQDxtvowAUn/images/intercom/36d8977cfb98a414.png?fit=max&auto=format&n=a7q81tQDxtvowAUn&q=85&s=e478f5294add210b9ad3922e348eb0aa" alt="Log into another account option for different Facebook user" width="1819" height="1544" data-path="images/intercom/36d8977cfb98a414.png" />
  </Step>

  <Step title="Select the Facebook ad account">
    A popup displays every ad account linked to your Facebook user. Select the **Facebook ad account** you want Upstack Data to read performance data from.

    <img src="https://mintcdn.com/upstackdata-afbed50d/a7q81tQDxtvowAUn/images/intercom/25ff4e1f9c755c96.jpg?fit=max&auto=format&n=a7q81tQDxtvowAUn&q=85&s=4b0f99514e846d26fcd09f6458f19903" alt="Facebook ad account selection popup with available accounts" width="1324" height="1195" data-path="images/intercom/25ff4e1f9c755c96.jpg" />
  </Step>

  <Step title="Save the configuration">
    Click the **Save** button.

    <img src="https://mintcdn.com/upstackdata-afbed50d/a7q81tQDxtvowAUn/images/intercom/0b10004688761519.jpg?fit=max&auto=format&n=a7q81tQDxtvowAUn&q=85&s=8ac1eb8f05435122efc84f21744f570b" alt="Save button to confirm Facebook ads connection" width="1318" height="1190" data-path="images/intercom/0b10004688761519.jpg" />

    <img src="https://mintcdn.com/upstackdata-afbed50d/a7q81tQDxtvowAUn/images/intercom/47af5780d5ad8fa0.png?fit=max&auto=format&n=a7q81tQDxtvowAUn&q=85&s=fa13686487aa1657d2194025cb29a277" alt="Facebook ads integration showing successful connection" width="1028" height="168" data-path="images/intercom/47af5780d5ad8fa0.png" />
  </Step>

  <Step title="Verify the integration is healthy">
    In the Upstack dashboard, the **Facebook ads** integration card should display **Healthy** with a green status indicator within 5 minutes.

    If the status shows **Unhealthy** or **Reconnect required**:

    * Confirm the Facebook user that authorized the connection still has access to the ad account.
    * Re-run the **Connect** flow and re-grant all requested permissions when prompted.
  </Step>
</Steps>