---
updatedAt: 2026-06-18T13:05:14.000Z
agentTools:
  projectIndex: https://docs.polytomic.com/llms.txt
---

# Facebook Ads token authentication

To authenticate Polytomic to Facebook Ads using a token, you'll create an app and system user in the Facebook Business Settings console for Polytomic to use.

1. Go to [Facebook Business Settings](https://business.facebook.com/settings/apps/) and click on **Apps** under the Accounts heading.
2. Click **Add** followed by **Create a new app ID** to begin creating an application for Polytomic to use.

![](https://files.readme.io/6f7ca7c513b4a84b9965c10488d468d945cd889b0ec8679eccd98523701dd946-image.png)

3. Fill out the app details appropriately.

![](https://files.readme.io/3a231a14da1839e53975fbc4197f8734f3abacb63080189a2a7ad7ab57c492df-image.png)

<br />

3. Click **Other** for the app use case then click **Next**.

![](https://files.readme.io/9e243d4f07bd8aba5d4300178156d92b82a99587a4071b22de4850f334186882-image.png)

4. Select **Business** for the app type then click **Next**.

![](https://files.readme.io/d1daaeb736b31e63fc8d75d30df47a8f8a4e577769a9e5871b5a49284837ad70-image.png)

5. Give the app a name and click **Create App**.

![](https://files.readme.io/47fb518af4dfffb35922adb6a7bcd56c4875fe62fae263e3bf50ee4055e1b9fd-image.png)

6. After creating your app you'll be presented with the App Dashboard. Copy the **App ID** at the top of the page.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/47ff1d6-app_dashboard.png",
        "",
        ""
      ],
      "align": "center"
    }
  ]
}
[/block]

7. Return to the Apps section of your [Facebook Business Settings](https://business.facebook.com/settings/apps/). If your app does not appear in the connect app list, click **Add** and select **Connect an app ID** to enter the app ID you copied in the previous step.
8. Go to **System users** under the **Users** section in the business manager.
9. Click **Add** to create a new system user for Polytomic to use. Provide a descriptive name, select **Admin** as the System user role, then click **Create system user**.

![](https://files.readme.io/208f67fda89b84c9a67adf35e12f446369e64086bce65b9b744a0d8ab7c7f946-image.png)

10. Click **Add Assets**.
11. Under **Ad accounts**, grant the system user full control for the Facebook ad accounts you wish to integrate with Polytomic.

![](https://files.readme.io/ac3560e9eb687022be69d37fd24b2272ccc0c6d1242865b001801ad221502dd6-image.png)

12. Under **Apps**, select the app you created and grant the system user full control. Click **Save changes**.

![](https://files.readme.io/4204a555dd53ae454c40508b877b1ae459a8065521b6890fe16890157674b112-image.png)

13. If you plan on sending conversions, make sure that you add the relevant datasets.

![](https://files.readme.io/4b9a07b53823d273457254070427aa67c4a6aa3857a462e069799bbbd72863f3-image.png)

<br />

13. Click **Generate new token**.
14. Select the app you created and set the token expiration. We recommend selecting **Never** to avoid the need to generate a new token every 60 days.

Select the following permissions from the list:

* `ads_management`
* `ads_read`
* `business_management`
* `read_insights`

15. Click **Generate token** and copy the resulting token.
16. You will also need your Facebook **Ad Account** ID (not business ID). Open the ads manager, and you can find it near the top of the page:

![](https://files.readme.io/67db30970cea347f7067db462a135d879bfaaa2aad907ca34fc5d629c3c7304f-image.png)

<br />

15. In Polytomic, go to **Connections** -> **Add connection** -> **Facebook Ads**.
16. Select **Token** as your authentication method:

![](https://files.readme.io/c4ab2cb30aaada7a30bb439effaeeeb2a5af9ce4c1c685aabc726aaf403f2426-image.png)

18. Paste the token from Step 15 into the **Token** field.
19. Click **Save**.