> For the complete documentation index, see [llms.txt](https://docs.getuntitled.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getuntitled.ai/integrations/destinations/meta-facebook-ads.md).
# Meta (Facebook Ads)
By syncing your audiences directly to Meta, your team can better automate and streamline your Facebook Ads Custom Audience and Lookalike Audience activation strategies.
## Accepting Custom Audience Terms of Service
{% hint style="info" %}
Before you can sync Untitled Audiences to Meta, you’ll need to accept Meta’s Custom Audience Terms of Service if you haven’t created a custom audience in your account prior. You can use the link below to navigate directly to the relevant section to complete this in Facebook.\
\
\
\
Ensure that, if you have multiple Facebook accounts, you use the account selector at the top-right of the page to select the advertising account you're going to use the custom audience with.
{% endhint %}
Terms of service webpage troubleshooting
If you are being redirected to the Ads Manager page on Facebook while trying to navigate between ad accounts on this page: , you may need to append "?act=\[ad account ID]" to the URL like this:\
Replace the X's with your ad account ID. To find your ad account ID, visit while logged in, and from the top drop-down, select the ad account you'd like to use with Untitled Audience syncs. The screenshot below shows where you will find the Ad account ID.
## Setting up Facebook Connections
{% embed url="" %}
Step-by-step setup guide with screenshots
{% hint style="info" %}
**Before you start**
* You need **admin** access to the Meta business portfolio that owns your ad account.
* You'll switch between Untitled, Meta Business Suite, and Meta for Developers. Keep all three tabs open.
* Meta shows the token only once. You only need to copy/paste it into Untitled one time, and generating a new token is straightforward.
{% endhint %}
### Start the Facebook connection
{% stepper %}
{% step %}
#### Open Integrations and add a destination
In the left sidebar, click **Integrations**. Then click **New integration** and choose **Connect a destination**.
Integrations → New integration → Connect a destination
{% endstep %}
{% step %}
#### Choose Facebook
Under **Destinations**, click **Facebook**.
Destinations → Facebook
{% endstep %}
{% step %}
#### Name the connection and keep System User selected
Enter a **Connection name**, such as “Facebook” and click Continue.
{% endstep %}
{% step %}
#### Leave the token screen open
Untitled now asks for a **System User Access Token**. Leave this tab as it is. You'll come back and paste the token at the end of this guide. Open Meta Business Suite in a new tab. This is the address you can open: [business.facebook.com/latest/settings/apps](https://business.facebook.com/latest/settings/apps).
{% endstep %}
{% endstepper %}
### Create a Meta app
The app is how Untitled calls the Marketing API on your behalf.
{% stepper %}
{% step %}
#### Go to Apps in business settings
Navigate to [business.facebook.com/latest/settings/apps](https://business.facebook.com/latest/settings/apps) and click **Add.**
Settings → Accounts → Apps → Add
{% endstep %}
{% step %}
#### Create a new app ID
In **What do you want to do?**, choose **Create a new app ID**. Meta for Developers opens in a new tab.
Create a new app ID
{% endstep %}
{% step %}
#### Enter the app details
Enter an **App name** (“getUntitled” is common) and an **App contact email** you check regularly. An email address may already be pre-filled. Click **Next**.
{% endstep %}
{% step %}
#### Choose the Marketing API use case
Check **Create & manage ads with Marketing API**, then scroll down and click **Next**.
{% endstep %}
{% step %}
#### Connect your business portfolio
Select the business portfolio that owns your ad account, then click **Next**.
{% endstep %}
{% step %}
#### Review and create the app
The **Requirements** step should say "no requirements were found". Click **Next**. On **Overview**, check the details and click **Create app**.
{% endstep %}
{% step %}
#### Go back to Business Suite
The app dashboard opens. There's nothing to change here. Switch back to the Meta Business Suite tab.
{% endstep %}
{% step %}
#### Refresh Apps and confirm the app is listed
Close the **What do you want to do?** dialog and refresh the page. Your new app now appears under **Apps**.
{% endstep %}
{% endstepper %}
### Create a system user and give it access
A system user isn't tied to a person, so the connection keeps working if someone leaves the team.
{% stepper %}
{% step %}
#### Open System users
In the settings sidebar, under **Users**, click **System users**.
Settings → Users → System users
{% endstep %}
{% step %}
#### Add an admin system user
Click **Add**. Enter a **System user name** like “getUntitled”, set **System user role** to **Admin**, and click **Create system user**.
Add → Name system user → Apply Admin role → Create system user
{% endstep %}
{% step %}
#### Select the new system user
A confirmation appears and the new user shows with **Admin access**. Select it, then click **Assign assets**.
{% endstep %}
{% step %}
#### Give it full control of the app
Under **Select asset type**, click **Apps**. Select your app, toggle on **Manage app** under Full access, and click **Assign assets**.
Apps → Manage app → Assign assets
{% endstep %}
{% step %}
#### Give it full control of your ad account
Click **Assign assets** *again*. Choose **Ad accounts**, check the ad account Untitled should sync to, turn on **Manage ad accounts**, and click **Assign assets**. Click **Done** on the confirmation.
Assign assets → Ad accounts → Manage ad accounts → Assign assets → Done
{% endstep %}
{% step %}
#### Check both assets are assigned
Refresh the page. Under **Assigned assets** you should see the ad account and the app, both with **Full access**.
{% endstep %}
{% endstepper %}
### Generate the access token
{% stepper %}
{% step %}
#### Generate a token for your app
With the system user selected, click **Generate token**. Under **Select app**, choose your app and click **Next**.
Generate token → Next
{% endstep %}
{% step %}
#### Set the token to never expire
Under **Token expiration**, choose **Never** and click **Next**. This selection is what makes this a one-time process for your entire account.
Never → Next
{% endstep %}
{% step %}
#### Add permissions to the token
Open **Select permissions** and check `ads_management` and `business_management`. Click **Generate token**.
Select permissions → Generate token
{% endstep %}
{% step %}
#### Copy the token
Meta shows the token once. Click **Copy**, then **Done**.
{% hint style="danger" %}
**Treat this token like a password.** Anyone who has it can manage your ad account. Don't paste it into chat or email, and hide it before you record or share your screen.
{% endhint %}
Copy → Done
{% endstep %}
{% endstepper %}
### Connect and move your existing syncs
{% stepper %}
{% step %}
#### Paste the token and connect
Go back to the Untitled tab you left open. Paste the token into **System User Access Token** and click **Connect**.
Connect
{% endstep %}
{% step %}
#### Choose where to move legacy destinations
If you have older Facebook destinations, Untitled asks which Facebook account to move them to. Pick the connection you just made and click **Continue**. If you see no prompt, you're done.
Integrations → Legacy Connections → Migrate → Continue
{% endstep %}
{% step %}
#### Check the audience matches and migrate
Untitled matches each sync to a Facebook audience by name. Check each match, change any that are wrong, then click **Migrate**. The button shows how many syncs will move.
Migrate
{% endstep %}
{% step %}
#### Confirm the migration
A confirmation appears and the destination shows its syncs as migrated. They keep writing to the same audiences on the same schedule.
{% endstep %}
{% endstepper %}
{% hint style="success" %}
**Facebook is connected**
Untitled can now send audiences to your ad account with the system user token. If syncs stop later, check that the system user still has **Manage ad accounts** access and that nobody revoked its token.
{% endhint %}
## Migrating Facebook Connections
If your Facebook <> Untitled accounts were connected prior to October 23, 2026, you will need to migrate to a new connection type. Migration is a one-time task that takes \~5 minutes. Please follow the guide below to migrate.
{% embed url="" %}
Step-by-step migration guide with screenshots
Move an older (Before October 20, 2026) Facebook destination and its syncs to the new Integrations workflow. Create a Meta app and a System User, generate a token that doesn't expire, and connect it to Untitled.
{% hint style="info" %}
**Before you start**
* You need **admin** access to the Meta business portfolio that owns your ad account.
* You'll switch between Untitled, Meta Business Suite, and Meta for Developers. Keep all three tabs open.
* Meta shows the token only once. Have somewhere safe to keep it, like your password manager.
{% endhint %}
{% stepper %}
{% step %}
### Start the migration in Untitled
#### Open Integrations
If you have connections to migrate, the **Home** page says so. In the left sidebar, click **Integrations**.
Integrations
#### Find the destination under Legacy Connections
Click the **Legacy Connections** tab. Under **Migrate your destinations**, find the Facebook destination you want to move and click **Migrate**.
Legacy Connections → Migrate
#### Create a new connection
Untitled asks which Facebook account to migrate the destination to. Open **Select a connection** and choose **Create new connection**.
Select a connection → Create new connection
#### Name the connection and keep System User selected
Enter a **Connection name**, such as “Facebook”. Leave **System User (recommended)** selected and click **Continue**. The dialog summarizes the Meta setup. The next sections walk through it.
System User (recommended) → Continue
#### Leave the token screen open
Untitled now asks for a **System User Access Token**. Leave this tab as it is. You'll come back and paste the token at the end of this guide. Switch to Meta Business Suite.
{% endstep %}
{% step %}
### Create a Meta app
The app is how Untitled calls the Marketing API on your behalf.
#### Go to Apps in business settings
In Meta Business Suite, open **Settings**. Under **Accounts**, click **Apps**, then click **Add**.
Go to [business.facebook.com/latest/settings/apps](https://business.facebook.com/latest/settings/apps).
Settings → Accounts → Apps → Add
#### Create a new app ID
In **What do you want to do?**, choose **Create a new app ID**. Meta for Developers opens in a new tab.
Create a new app ID
#### Enter the app details
Enter an **App name** (the video uses “getUntitled”) and an **App contact email** you check regularly. Click **Next**.
Go to [developers.facebook.com/apps/creation](https://developers.facebook.com/apps/creation).
Next
#### Choose the Marketing API use case
Check **Create & manage ads with Marketing API**, then click **Next**.
Create & manage ads with Marketing API → Next
#### Connect your business portfolio
Select the business portfolio that owns your ad account, then click **Next**.
Next
#### Review and create the app
The **Requirements** step should say no requirements were found. Click **Next**. On **Overview**, check the details and click **Create app**.
Next → Create app
#### Go back to Business Suite
The app dashboard opens. There's nothing to change here. Switch back to the Meta Business Suite tab.
#### Refresh Apps and confirm the app is listed
Close the **What do you want to do?** dialog and refresh the page. Your new app now appears under **Apps**.
{% endstep %}
{% step %}
### Create a system user and give it access
A system user isn't tied to a person, so the connection keeps working if someone leaves the team.
#### Open System users
In the settings sidebar, under **Users**, click **System users**. Then click **Add**.
Settings → Users → System users → Add
#### Add an admin system user
Enter a **System user name** (the video uses “getUntitled”), set **System user role** to **Admin**, and click **Create system user**.
Create system user
#### Select the new system user
A confirmation appears and the new user shows with **Admin access**. Select it, then click **Assign assets**.
Assign assets
#### Give it full control of the app
Under **Select asset type**, click **Apps**. Check your app, turn on **Manage app** under Full access, and click **Assign assets**. Click **Done** on the confirmation.
Apps → Manage app → Assign assets → Done
#### Give it full control of your ad account
Click **Assign assets** again. Choose **Ad accounts**, check the ad account Untitled should sync to, turn on **Manage ad accounts**, and click **Assign assets**. Click **Done** on the confirmation.
Assign assets → Ad accounts → Manage ad accounts → Assign assets → Done
#### Check both assets are assigned
Refresh the page. Under **Assigned assets** you should see the ad account and the app, both with **Full access**.
{% endstep %}
{% step %}
### Generate the access token
#### Start a token for your app
With the system user selected, click **Generate token**. Under **Select app**, choose your app and click **Next**.
Generate token → Next
#### Set the token to never expire
Under **Token expiration**, choose **Never** and click **Next**. Meta suggests 60 days, but a token that expires would stop your syncs until someone makes a new one.
Never → Next
#### Add the two permissions
Open **Select permissions** and check `ads_management` and `business_management`. Click **Generate token**.
Select permissions → Generate token
#### Copy the token
Meta shows the token once. Click **Copy**, then **Done**.
{% hint style="danger" %}
**Treat this token like a password.** Anyone who has it can manage your ad account. Don't paste it into chat or email, and hide it before you record or share your screen.
{% endhint %}
Copy → Done
{% endstep %}
{% step %}
### Connect and finish the migration
#### Paste the token and connect
Go back to the Untitled tab you left open. Paste the token into **System User Access Token** and click **Connect**. Untitled confirms the connection and moves on to your syncs.
Connect
#### Check the audience matches and migrate
Untitled matches each sync to a Facebook audience by name. Check each match, change any that are wrong, then click **Migrate**. The button shows how many syncs will move.
Migrate
#### Confirm the migration
A **Migrated** confirmation appears and the destination shows its syncs as migrated. They keep writing to the same audiences on the same schedule.
#### Check the new connection
Click the **Integrations** tab. The new Facebook connection is listed with its ad account and syncs.
Integrations
{% hint style="success" %}
**Your Facebook destination is migrated**
Untitled now sends these audiences through the new connection. If you have other legacy Facebook destinations, click **Migrate** next to each one and choose this connection instead of creating a new one. If syncs stop later, check that the system user still has **Manage ad accounts** access and that nobody revoked its token.
{% endhint %}
{% endstep %}
{% endstepper %}
Prefer to migrate alongside an Untitled team member? Email to set up a one-on-one meeting to migrate!
Legacy Walkthrough Video for System User Method
{% embed url="" %}
Legacy Step-by-Step Guide for System User Setup
### Destination Overview
Meta (Facebook Ads) is one of the most powerful digital advertising platforms available, enabling businesses to reach their audiences across Facebook, Instagram, and the broader Meta ecosystem.\
This guide will walk you through how to configure Meta as a destination within Untitled and how to send audiences effectively for advertising activation.
### Connection Setup
#### Log into Untitled
1. First, log into your Untitled account.
2. Select Destinations in the left navigation menu.
3. Find Meta (Facebook Ads) and click Connect.
4. A popup modal will appear with a link. Select `Continue` and you'll be redirected to a new window.
5. Press `Continue` on this authentication page.
6. Proceed with Authenticating Facebook Ads (META) via your preferred Authentication Method.
### Meta / Facebook Ads Authentication Methods
Facebook Ads supports two separate authentication mechanisms: OAuth (Login with your Facebook profile) and System User. **We recommend using System User for the most reliable connection** long term as it does not require re-authentication every 30 days. Both methods are documented in this article, so you may proceed with the option that best suits your workflow.
{% hint style="info" %}
The System User Authentication method typically takes 10–15 minutes to complete. Please plan accordingly if you choose this option.
{% endhint %}
### **1. System User (Recommended)**
For long-term stability, we recommend using a System User, which doesn't require periodic re-authentication every 30 days. The setup steps to complete this preferred authentication method are contained below.
#### **Steps to set up a System User—Part A, Creating an Application**
To generate a System User token, you'll first need to create an app. In the Facebook ecosystem, a custom application serves primarily to manage authentication tokens for accessing the Meta API platform.
If you don't have an app already, you can create one with the following steps:
1. Navigate to [Facebook Business Manager](https://business.facebook.com/).
2. Go to **Business Settings > Accounts > Apps**.
3. Click **Add** and select **Create New App ID**.
4. Choose `Other` for the use case.
5. Then for the Type, select `Business`.
6. Fill out the relevant details for the app (name the app something descriptive and memorable such as '*Untitled Audience Integration*', and fill in your own email for the app contact).
Now you can move on to generating a system user for the app!
#### **Steps to set up a System User—Part B, Creating a System User for the App**
1. Go to your Business Manager and navigate to **Business Settings > Users > System Users**
2. Click **Add** to create a new System User.
3. Assign a name and select the `Employee` role.
#### **Steps to set up a System User—Part C, Assigning the System User to the App**
1. After creating the System User, click **Add Assets**.
2. Assign the App you created in previous steps to the System User. Make sure to assign ***full control***** (**`Manage app: True` ) of the app to the System User and then press `Save changes`.
3. You'll also need to assign your System User ***full control*** (`Manage ad accounts: True`) over any Ad Accounts that you'd like to sync Untitled data to for Custom Audiences. Once you've done so, press `Save changes`.
{% hint style="danger" %}
Step 3 is commonly overlooked by users during setup!\
To ensure your **Meta destination** is properly configured in Untitled, you must assign the **System User** **full control** **of the Ad Account.**
{% endhint %}
#### **Steps to set up a System User—Part D, Generating an Access Token for the System User**
1. Within the System User settings, click **Generate New Token**.
2. Select the app you created.
3. Ensure the token has the `ads_management` Permissions scope.
4. Set the token to **Never Expire** (this will prevent the need to re-authenticate your integration within Untitled every 60 days).
5. Press `Generate token`.
6. Save this token securely; it will be used to authenticate the connection in Untitled (see following step).
7. **Paste** the System User Token into the 'System User Token' text box field and press `Continue`.
8. Once the System User has been successfully authenticated, the Facebook Ads (Meta) Destination will appear in your 'Connected Destinations' library. If the setup is complete, a green success indicator will be displayed next to the destination (see image below for reference).
9. Once you see this green success indicator and the authentication test has been completed, feel free to close the connection bridge URL.
Now that you've successfully authenticated your Meta destination using a System User token, please proceed to the '[Syncing an Untitled Audience to Meta (Facebook Ads)](#syncing-an-untitled-audience-to-meta-facebook-a-ds)' section of this article.
### **2. Using OAuth (**Login with your Facebook Profile)
Alternatively, you can use OAuth to authenticate the Destination. However, please note that **this connection WILL EXPIRE after 30 days.** Once expired, your Untitled Audiences will no longer sync or update in Meta until the connection is re-authenticated.
#### **Steps to set up an OAuth Connection**
1. Within the initial Destination setup steps, you were asked to [open the connection bridge url link](#log-into-distilled). Navigate to this URL.
2. Select the "Login" authentication preference
3. Follow the on-screen prompts to sign in with your Facebook account and select the Ad Accounts you plan to sync Untitled Audiences to.
{% hint style="info" %}
Note: If your user is not assigned the Manager role for the Facebook Ad Account(s) you plan to connect, you will not be able to complete this step successfully until access is granted.
{% endhint %}
4. Once you've successfully logged in and authorized the connection, press `continue` to verify the authentication.
5. Once the authentication test has been completed, feel free to close the connection bridge URL and proceed to the Audience Sync setup steps below.
Now that you've successfully authenticated your Meta destination using an OAuth sign-in (Login with your Facebook profile), please proceed to the '[Syncing an Untitled Audience to Meta (Facebook Ads)](#syncing-an-untitled-audience-to-meta-facebook-a-ds)' section of this article.
### Syncing an Untitled Audience to Meta (Facebook Ads)
1. Navigate to the Audience Library in your Untitled Account
2. Click on the audience you want to sync to Facebook.
3. Navigate to the "Destinations" tab within the Audience, and click `Setup sync`
4. A pop-up confirmation modal will appear. Type in the audience name and then click `Continue`
5. After completing this step, you’ll see a confirmation screen and a green ' ✔️ Connected' message will also appear on the Facebook Available Destination tile.
6. A Custom Audience will be created in Meta and will begin populating shortly with your selected Untitled Audience. Once active, you can attach it to any existing or new ad campaign to begin advertising to your target segment. The audience will automatically refresh daily at 12:15 EST in Meta from that point forward.
## Need Further Support or Have Additional Questions?
Check out our[ FAQs ](/misc/frequently-asked-questions.md)to get some answers, start a chat on our [website](https://getuntitled.ai/), or get connected directly with our team [here](https://getuntitled.ai/contact/).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.getuntitled.ai/integrations/destinations/meta-facebook-ads.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
.png?alt=media&token=aeffd21d-df06-4b59-b6be-677740fce86b)
.png?alt=media&token=993a68d3-fb14-427e-a98f-73526e6caef3)
