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

# Meta Ads: Connect the account

## Step 1: Connect Your Meta Ad Account

### What does the connection do?

Northbeam natively integrates with the Meta Ads API. By doing so, we pull all your current and historical Campaigns, Adsets, and Ads from your account, along with a list of useful metrics.  Notably, we pull impressions, which fuel our view model and unlock our Clicks + Modeled Views attribution model. We also pull ad spend and list of in-platform conversion & creative metrics to help you with decision making.

### How to connect your Ad Account

How to connect:

* **Onboarding Flow** - If you're in our onboarding flow, please navigate to **Integrations**
* **Activated Dashboard** - If your dashboard is activated, please go to **Settings > Connections**

<br />

<Warning>
  Note: The credentials used must have admin access to the Ad Account.
</Warning>

<br />

<Note>
  Additional Meta Permission Requirements

  The user connecting must have both **`ads_read`** and **`ads_management`** permissions enabled in their **Meta Business Manager**.

  These permissions fall under **Advanced Access**, which is required for third-party integrations like Northbeam to read and manage ad data.

  To verify or request these permissions, go to:\
  **Meta Business Manager → App Dashboard → App Review → Permissions and Features**

  For more information, visit Meta’s documentation:\ [https://developers.facebook.com/docs/marketing-api/get-started/authorization/#permissions-and-features](https://developers.facebook.com/docs/marketing-api/get-started/authorization/#permissions-and-features)
</Note>

For a visual walkthrough, reference the video below.

<Frame>
  <iframe src="https://www.loom.com/embed/d1d83910b47b48eeba950e9b46a38aaa?sid=549b5b43-b6a8-4cb4-8485-2da14cc057dd" width="100%" height="450" allowfullscreen />
</Frame>