> For the complete documentation index, see [llms.txt](https://docs.appmixer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.appmixer.com/connector-configuration/facebook-business.md).

# Facebook Business

## OAuth app properties

| Property                | Value                                                                                                                                                                                                                                                                                                                                                |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Multi-tenant**        | **Conditional.** People without a role on the app can connect only after the app has *Advanced Access* to `ads_management`. With *Standard Access*, only the app's admins, developers and testers can connect.                                                                                                                                       |
| **Vendor review**       | **Required** for users without a role on the app: App Review for Advanced Access to `ads_management`, and Business Verification of the business portfolio the app is connected to. Apps with Advanced Access must also complete the yearly Data Use Checkup.                                                                                         |
| **Review time**         | App Review: usually under a week, often 2–3 days, longer at peak times. Business Verification: not published.                                                                                                                                                                                                                                        |
| **Users before review** | Only people with a role on the app (admin, developer, tester).                                                                                                                                                                                                                                                                                       |
| **App owner**           | A Meta developer account. For Advanced Access the app must be connected to a verified business portfolio, and only an admin of that business portfolio can complete the verification.                                                                                                                                                                |
| **Regions**             | One app works worldwide.                                                                                                                                                                                                                                                                                                                             |
| **Client secret**       | No expiry documented.                                                                                                                                                                                                                                                                                                                                |
| **Rate limits**         | Counted per ad account, with limits set by the app's *Marketing API Access Tier*. *Limited Access* (the default, meant for development): Ads Management 300 + 40 × active ads per hour, Custom Audience 5,000 + 40 × active custom audiences per hour. *Full Access*: 100,000 + 40 × active ads and 190,000 + 40 × active custom audiences per hour. |
| **Checked**             | 2026-11-13                                                                                                                                                                                                                                                                                                                                           |

**Limitations**

* The Marketing API Access Tier is separate from App Review. To upgrade from Limited to Full Access (**+Upgrade** on the *Marketing API Access Tier* feature), the app needs at least 500 Marketing API calls in the last 15 days with an error rate below 15%.
* With Standard Access, `ads_management` works only for the ad accounts of people with a role on the app. Managing other people's ad accounts needs Advanced Access.
* A Facebook user token lasts about 60 days. Meta does not exchange an expired token for a new one, so once it expires the user has to connect the account again.

Sources: [Access levels](https://developers.facebook.com/docs/graph-api/overview/access-levels/), [Marketing API authorization](https://developers.facebook.com/docs/marketing-api/overview/authorization/), [Marketing API rate limiting](https://developers.facebook.com/docs/marketing-api/overview/rate-limiting/), [App Review](https://developers.facebook.com/docs/resp-plat-initiatives/app-review/introduction), [Business Verification](https://developers.facebook.com/docs/development/release/business-verification), [Long-lived tokens](https://developers.facebook.com/docs/facebook-login/guides/access-tokens/get-long-lived/). What the rows mean: [OAuth app properties](https://docs.appmixer.com/connector-configuration/oauth-app-properties.md).

## Create Facebook OAuth Application

1. Visit <https://developers.facebook.com/> and create a new OAuth application (or use your existing one).
2. Add **Facebook Login for Business** and **Marketing API** products.\\

   <figure><img src="https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-8c6f0ef65f78cbf2f7417be9982c3fe14c6a1360%2Fimage%20(149).png?alt=media" alt=""><figcaption></figcaption></figure>
3. Copy the **App ID** and **App Secret**; see [Backoffice configuration](#backoffice-configuration):\\

   <figure><img src="https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-5fb5539bc4af3ebcb49f459b291c357d840dcab3%2Fimage%20(150).png?alt=media" alt=""><figcaption></figcaption></figure>
4. Add your Appmixer tenant domains as your **App domains**:\\

   <figure><img src="https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-56d540267bc671159537907891929bcf2dcce5ad%2Fimage%20(153).png?alt=media" alt=""><figcaption></figcaption></figure>

   Note: replace YOUR\_TENANT with the name of your hosted tenant. If you're a customer on an Appmixer Self-Managed plan, you can have a completely custom domains that Appmixer runs on. Use your own domains instead.
5. Set the OAuth redirect URI under **Facebook Login for Business** / **Settings** to `https://api.YOUR_TENANT.appmixer.cloud/auth/facebookbusiness/callback`:\\

   <figure><img src="https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-6a71be1e6fad1407e5aec04ce1a32b6b7b3b1e04%2Fimage%20(154).png?alt=media" alt=""><figcaption></figcaption></figure>

## Backoffice configuration

Configuration ID: `appmixer:facebookbusiness` (Backoffice → Configuration; see [Connector Configuration](https://docs.appmixer.com/getting-started/services) for how a configuration is created and how its keys reach the connector).

<figure><img src="https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-39c1347a867f64acc4a6623dc6fa23ce7947013f%2Fimage%20(151).png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-0c96d6a8e63679399acd1a9f5c7846e70388166a%2Fimage%20(152).png?alt=media" alt=""><figcaption><p>Use App ID as clientId and App Secret as clientSecret</p></figcaption></figure>

* `clientId` — App ID of the Facebook app created above. Not needed when Facebook Business is authenticated through the Appmixer Auth Hub.
* `clientSecret` — App secret of the same app. Not needed with the Auth Hub.
* `listCacheTTL` — Optional. How long, in milliseconds, the ad account and custom audience lists of **GetAdAccounts** and **GetCustomAudiences** are cached. Default `120000` (2 minutes).
* `batchSize` — Optional. How many audience members **AddMembersFromCSVToAudience**, **RemoveMembersInCSVFromAudience** and **ReplaceMembersFromCSVInAudience** upload to Facebook in one request. Default `10000`.
* `timeoutTriggerSeconds` — Optional. How long, in seconds, one run of these CSV components uploads before it stops and schedules the rest for a later run. Keep it under 23 minutes. Default `300` (5 minutes).
* `timeoutSeconds` — Optional. How long, in seconds, the CSV components wait before they continue the upload. Default `60`.
* `maxContinuationPeriodSeconds` — Optional. How long, in seconds, the CSV components keep trying to finish an upload. Default `43200` (12 hours).

The same keys can be set with the CLI (`-u` updates the existing configuration instead of creating it):

```bash
appmixer service-config set appmixer:facebookbusiness -u -d '{
  "clientId": "<app id>",
  "clientSecret": "<app secret>"
}'
```


---

# 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.appmixer.com/connector-configuration/facebook-business.md?ask=<question>&goal=<user_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.
