> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Facebook Business connector

- Connector: `appmixer.facebookbusiness`
- Version: 3.1.3
- Components: 12 (0 triggers, 12 actions)

Manage Facebook business tools such as Ads and Campaigns.

- Connector page: <https://connectors.appmixer.com/connector/appmixer.facebookbusiness/3.1.3>
- Source code: <https://github.com/clientIO/appmixer-connectors/tree/dev/src/appmixer/facebookbusiness>
- Download package: <https://connectors.appmixer.com/connector/appmixer.facebookbusiness/3.1.3/download>

## Authentication

**Type:** OAuth 2

This connector is globally authenticated and verified by Appmixer (Authentication Hub) and is ready to use without registering your own OAuth application with the provider. You can still use your own OAuth credentials (clientId and clientSecret) - see the Connector Configuration section of the documentation. The Authentication Hub is enabled for all hosted Appmixer tenants; on self-managed installations it has to be explicitly set.

**Scopes:**

- `public_profile`
- `email`

## Actions (12)

- [Add Member To Audience](https://connectors.appmixer.com/connector/appmixer.facebookbusiness/3.1.3/component/appmixer.facebookbusiness.marketing.AddMemberToAudience.md) (`appmixer.facebookbusiness.marketing.AddMemberToAudience`): Add a single customer to a custom audience. Additional scopes: `ads_management`.
- [Create Audience](https://connectors.appmixer.com/connector/appmixer.facebookbusiness/3.1.3/component/appmixer.facebookbusiness.marketing.CreateAudience.md) (`appmixer.facebookbusiness.marketing.CreateAudience`): Create a new custom audience. Additional scopes: `ads_management`.
- [Add Members From C S V To Audience](https://connectors.appmixer.com/connector/appmixer.facebookbusiness/3.1.3/component/appmixer.facebookbusiness.marketing.AddMembersFromCSVToAudience.md) (`appmixer.facebookbusiness.marketing.AddMembersFromCSVToAudience`): Add customers from a CSV file to a custom audience. Additional scopes: `ads_management`.
- [Delete Audience](https://connectors.appmixer.com/connector/appmixer.facebookbusiness/3.1.3/component/appmixer.facebookbusiness.marketing.DeleteAudience.md) (`appmixer.facebookbusiness.marketing.DeleteAudience`): Delete a custom audience by ID. Additional scopes: `ads_management`.
- [Get Ad Accounts](https://connectors.appmixer.com/connector/appmixer.facebookbusiness/3.1.3/component/appmixer.facebookbusiness.marketing.GetAdAccounts.md) (`appmixer.facebookbusiness.marketing.GetAdAccounts`): Return a list of ad accounts associated with the user. Additional scopes: `ads_management`.
- [Get Campaigns](https://connectors.appmixer.com/connector/appmixer.facebookbusiness/3.1.3/component/appmixer.facebookbusiness.marketing.GetCampaigns.md) (`appmixer.facebookbusiness.marketing.GetCampaigns`): Get a list of your Facebook Ad Campaigns. Additional scopes: `ads_management`.
- [Get Custom Audiences](https://connectors.appmixer.com/connector/appmixer.facebookbusiness/3.1.3/component/appmixer.facebookbusiness.marketing.GetCustomAudiences.md) (`appmixer.facebookbusiness.marketing.GetCustomAudiences`): Return a list of custom audiences associated with an ad account. Additional scopes: `ads_management`.
- [Make Api Call](https://connectors.appmixer.com/connector/appmixer.facebookbusiness/3.1.3/component/appmixer.facebookbusiness.marketing.MakeApiCall.md) (`appmixer.facebookbusiness.marketing.MakeApiCall`): Performs an arbitrary authorized API call to the Facebook Marketing API. Additional scopes: `ads_management`.
- [Remove Member From Audience](https://connectors.appmixer.com/connector/appmixer.facebookbusiness/3.1.3/component/appmixer.facebookbusiness.marketing.RemoveMemberFromAudience.md) (`appmixer.facebookbusiness.marketing.RemoveMemberFromAudience`): Remove a single customer from a custom audience. Additional scopes: `ads_management`.
- [Remove Members In C S V From Audience](https://connectors.appmixer.com/connector/appmixer.facebookbusiness/3.1.3/component/appmixer.facebookbusiness.marketing.RemoveMembersInCSVFromAudience.md) (`appmixer.facebookbusiness.marketing.RemoveMembersInCSVFromAudience`): Remove customers in a CSV file from a custom audience. Additional scopes: `ads_management`.
- [Replace Members From C S V In Audience](https://connectors.appmixer.com/connector/appmixer.facebookbusiness/3.1.3/component/appmixer.facebookbusiness.marketing.ReplaceMembersFromCSVInAudience.md) (`appmixer.facebookbusiness.marketing.ReplaceMembersFromCSVInAudience`): Replace customers from a CSV file in a custom audience. Additional scopes: `ads_management`.
- [Update Audience](https://connectors.appmixer.com/connector/appmixer.facebookbusiness/3.1.3/component/appmixer.facebookbusiness.marketing.UpdateAudience.md) (`appmixer.facebookbusiness.marketing.UpdateAudience`): Update an existing custom audience. Additional scopes: `ads_management`.

## Changelog

### 3.1.3

- Security: upgraded csv-parse to 7.0.3 (GHSA-8cw4-87c7-c6xx, prototype replacement via the columns option). No change to how the audience CSV files are read.
- Remove Members In CSV From Audience: the Number of Entries output (num_total_entries) is now offered in the variable picker; the component already returned it.

### 3.1.2

- MakeApiCall: Request Headers and Query Parameters set in the Designer are now sent. They were silently dropped: the key-value field stores its rows as a JSON object string, which the component did not parse.

### 3.1.1

- Added MakeApiCall component for performing arbitrary authorized API calls to the Facebook Marketing API.

### 3.0.1

- Added output examples to component schemas.

### 2.1.1

- Fix validateAccessToken in auth.js.
- Bump Graph API from v20.0 to v25.0.

### 2.1.0

- Add support for custom delimiter in AddMembersFromCSVToAudience, ReplaceMembersFromCSVInAudience and RemoveMembersInCSVFromAudience.
- Removed dependency on fbgraph library.

### 2.0.0

- Support for sessions to upload large number of users.
- New: RemoveMembersInCSVFromAudience, ReplaceMembersFromCSVInAudience
- Changed: schema configuration for AddMembersFromCSVToAudience.

### 1.0.0

- Initial version
