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

# Facebook Ads - Getting started in Peliqan

> Create a Meta developer app and system user token, then connect Facebook Ads to Peliqan to sync campaign and ad performance data into your data warehouse.

This article provides an overview to get started with the **Facebook Ads** connector in **Peliqan**. Please [contact support](https://peliqan.io/contact) if you have any additional questions or remarks.

# How to connect Facebook Ads in Peliqan

### Step 1: Create a Meta Developer Account

1. Go to [https://developers.facebook.com](https://developers.facebook.com/)
2. Log in with your Facebook account.
3. Accept the Meta Developer Terms and set up your Developer profile

### Step 2: Create a New App

1. In the top-right corner, click **"My Apps" > "Create App"**.
2. Enter the app name and your contact email:

<img src="https://mintcdn.com/peliqan-9d7f0393/-nwNqUkSPUzSM-9F/images/Facebook%20Ads%20-%20Getting%20started%20in%20Peliqan/Screenshot_2025-05-07_at_08.17.46.png?fit=max&auto=format&n=-nwNqUkSPUzSM-9F&q=85&s=faeba849487806e85ffdca783d5d51fe" alt="Meta app creation form" width="3084" height="1084" data-path="images/Facebook Ads - Getting started in Peliqan/Screenshot_2025-05-07_at_08.17.46.png" />

3. Select **"Other"** as the use case:

<img src="https://mintcdn.com/peliqan-9d7f0393/-nwNqUkSPUzSM-9F/images/Facebook%20Ads%20-%20Getting%20started%20in%20Peliqan/Screenshot_2025-05-07_at_08.20.54.png?fit=max&auto=format&n=-nwNqUkSPUzSM-9F&q=85&s=bf26e25efa1c94b64ac87be38aa90634" alt="Meta app use case selection" width="3292" height="2174" data-path="images/Facebook Ads - Getting started in Peliqan/Screenshot_2025-05-07_at_08.20.54.png" />

4. Select **"Business"** as the app type:

<img src="https://mintcdn.com/peliqan-9d7f0393/-nwNqUkSPUzSM-9F/images/Facebook%20Ads%20-%20Getting%20started%20in%20Peliqan/Screenshot_2025-05-07_at_08.18.25.png?fit=max&auto=format&n=-nwNqUkSPUzSM-9F&q=85&s=0d0064b2d09d5b25feea038606239cd8" alt="Meta app type selection" width="3084" height="1080" data-path="images/Facebook Ads - Getting started in Peliqan/Screenshot_2025-05-07_at_08.18.25.png" />

5. Choose your **Business Manager account** (if you have one):

<img src="https://mintcdn.com/peliqan-9d7f0393/-nwNqUkSPUzSM-9F/images/Facebook%20Ads%20-%20Getting%20started%20in%20Peliqan/Screenshot_2025-05-07_at_08.18.42.png?fit=max&auto=format&n=-nwNqUkSPUzSM-9F&q=85&s=aea3355af72fa8267b0ed70e1c297750" alt="Meta Business Manager selection" width="3084" height="1218" data-path="images/Facebook Ads - Getting started in Peliqan/Screenshot_2025-05-07_at_08.18.42.png" />

6. Click **"Create App"**.

### Step 3: Add the "Marketing API" product

1. On the **Dashboard** of your app, in the center pane, scroll down to **"Add Products to Your App"** and Add the **Marketing API:**

<img src="https://mintcdn.com/peliqan-9d7f0393/-nwNqUkSPUzSM-9F/images/Facebook%20Ads%20-%20Getting%20started%20in%20Peliqan/Screenshot_2025-05-07_at_08.22.33.png?fit=max&auto=format&n=-nwNqUkSPUzSM-9F&q=85&s=646ebd90b9c61df1ee1780d85fb2f0f7" alt="Adding Marketing API product" width="3850" height="1528" data-path="images/Facebook Ads - Getting started in Peliqan/Screenshot_2025-05-07_at_08.22.33.png" />

### Step 4: Create a System User and get a token

Create a System User in the Facebook Business Manager and create a token for the System User.

1. Create a System User (to have a permanent token):

[Facebook Business Manager > System Users](https://business.facebook.com/settings)

2. Assign assets to the System User:
   * Add Facebook page(s) - e.g. for the \[/instagram-getting-started-in-peliqan]\(Instagram connector), make sure to select a Facebook page which is linked to the Instagram Business Account
   * Add the app (with permission "full access")
3. Generate a token for the System User:

   * Select your Facebook app
   * Expiration: never
   * Assign permissions: `pages_show_list`, `pages_read_engagement`, `instagram_basic`, `instagram_manage_insights`

   *Note: the instagram scopes are only needed if you will re-use this token for the Instagram connector*

### Step 5: Get your Ad Account ID

1. Click on the **Tools** menu item in the top menu present on the top of the page and then click on the **VIEW ALL TOOLS** menu item:

<img src="https://mintcdn.com/peliqan-9d7f0393/-nwNqUkSPUzSM-9F/images/Facebook%20Ads%20-%20Getting%20started%20in%20Peliqan/Screenshot_2025-05-19_at_21.36.47.png?fit=max&auto=format&n=-nwNqUkSPUzSM-9F&q=85&s=266de020ef9913199564548fabeac4bc" alt="Meta Tools menu" width="1460" height="626" data-path="images/Facebook Ads - Getting started in Peliqan/Screenshot_2025-05-19_at_21.36.47.png" />

2. On the **Developer Tools** page, click on **Business Tools > Ads Manager** on the right hand side of the page:

<img src="https://mintcdn.com/peliqan-9d7f0393/-nwNqUkSPUzSM-9F/images/Facebook%20Ads%20-%20Getting%20started%20in%20Peliqan/Screenshot_2025-05-19_at_21.38.33.png?fit=max&auto=format&n=-nwNqUkSPUzSM-9F&q=85&s=3597464980878bd92cac663bbd1b2ba2" alt="Meta Ads Manager selection" className="mx-auto" style={{ width:"42%" }} width="456" height="386" data-path="images/Facebook Ads - Getting started in Peliqan/Screenshot_2025-05-19_at_21.38.33.png" />

3. Your Ad Account ID is visible in the top left corner, copy it and paste it in Peliqan:

<img src="https://mintcdn.com/peliqan-9d7f0393/-nwNqUkSPUzSM-9F/images/Facebook%20Ads%20-%20Getting%20started%20in%20Peliqan/Screenshot_2025-05-19_at_21.39.38.png?fit=max&auto=format&n=-nwNqUkSPUzSM-9F&q=85&s=6e272ab093c9ce6d256a749f127f6b6c" alt="Meta Ad Account ID" width="1658" height="610" data-path="images/Facebook Ads - Getting started in Peliqan/Screenshot_2025-05-19_at_21.39.38.png" />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.