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

# Facebook Ads

> How to set up the Facebook Ads connector, plus the actions that are available.

![Facebook Ads](https://stackone-logos.com/api/facebook/filled/svg)

Previewv2.0.0[See changelog](https://docs.stackone.com/connectors/facebookads/changelog.md)

[53 actions](#actions) · 2 auth methods

Advertising

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/facebookads/guides/connector-profile/oauth-2-0.md)
>
> Requires a Meta App with Marketing API access and Facebook Login for Business configured. Business Verification and App...

> [card] [System User Access Token · Connector Profile](https://docs.stackone.com/connectors/facebookads/guides/connector-profile/system-user-access-token.md)
>
> For server-to-server use without a browser OAuth flow. Generate a System User access token in Meta Business Settings > U...

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/facebookads/guides/link-account/oauth-2-0.md)

> [card] [System User Access Token · Link Account](https://docs.stackone.com/connectors/facebookads/guides/link-account/system-user-access-token.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Scopes

Select all
|
Clear

ads\_management

ads\_read

business\_management

leads\_retrieval

pages\_manage\_ads

pages\_show\_list

public\_profile

No scopes found

53 actions

ActionDescriptionRequired scopes

List Ad Accounts`facebookads_list_ad_accounts`

List all ad accounts accessible to the authenticated user

`ads_read`

Get Ad Account`facebookads_get_ad_account`

Get details for a specific ad account

`ads_read`

Get Ad Account Insights`facebookads_get_ad_account_insights`

Get performance insights for a specific ad account

`ads_read`

Update Ad Account`facebookads_update_ad_account`

Update an existing ad account

`ads_management`

List Ad Creatives`facebookads_list_ad_creatives`

List all ad creatives in an ad account

`ads_read`

Get Ad Creative`facebookads_get_ad_creative`

Get details for a specific ad creative

`ads_read`

Create Ad Creative`facebookads_create_ad_creative`

Create a new ad creative

`ads_management`

Delete Ad Creative`facebookads_delete_ad_creative`

Delete an ad creative

`ads_management`

List Ads By Account`facebookads_list_ads_by_account`

List all ads in an ad account

`ads_read`

List Ads By Ad Set`facebookads_list_ads_by_adset`

List all ads for a specific ad set

`ads_read`

Get Ad`facebookads_get_ad`

Get details for a specific ad

`ads_read`

Create Ad`facebookads_create_ad`

Create a new ad

`ads_management`

Update Ad`facebookads_update_ad`

Update an existing ad

`ads_management`

Delete Ad`facebookads_delete_ad`

Delete an ad

`ads_management`

Get Ad Insights`facebookads_get_ad_insights`

Get performance insights for a specific ad

`ads_read`

List Ad Sets By Account`facebookads_list_adsets_by_account`

List all ad sets in an ad account

`ads_read`

List Ad Sets By Campaign`facebookads_list_adsets_by_campaign`

List all ad sets for a specific campaign

`ads_read`

Get Ad Set`facebookads_get_adset`

Get details for a specific ad set

`ads_read`

Create Ad Set`facebookads_create_adset`

Create a new ad set with targeting

`ads_management`

Update Ad Set`facebookads_update_adset`

Update an existing ad set

`ads_management`

Delete Ad Set`facebookads_delete_adset`

Delete an ad set

`ads_management`

Get Ad Set Insights`facebookads_get_adset_insights`

Get performance insights for a specific ad set

`ads_read`

List Pixels`facebookads_list_ads_pixels`

List all pixels for an ad account

`ads_read`

Get Pixel`facebookads_get_ads_pixel`

Get pixel details and configuration

`ads_read`

Create Pixel`facebookads_create_ads_pixel`

Create new tracking pixel

`ads_management`

Get Business`facebookads_get_business`

Get details for a specific Business

`business_management`

List Business Owned Ad Accounts`facebookads_list_business_owned_ad_accounts`

List ad accounts owned by a Business

`business_management`

List Business Client Ad Accounts`facebookads_list_business_client_ad_accounts`

List ad accounts a Business has access to as a client

`business_management`

List Campaigns`facebookads_list_campaigns`

List all campaigns in an ad account

`ads_read`

Get Campaign`facebookads_get_campaign`

Get details for a specific campaign

`ads_read`

Create Campaign`facebookads_create_campaign`

Create a new advertising campaign

`ads_management`

Update Campaign`facebookads_update_campaign`

Update an existing campaign

`ads_management`

Delete Campaign`facebookads_delete_campaign`

Delete a campaign

`ads_management`

Get Campaign Insights`facebookads_get_campaign_insights`

Get performance insights for a specific campaign

`ads_read`

List Custom Audiences`facebookads_list_custom_audiences`

List all custom audiences in an ad account

`ads_management`

Get Custom Audience`facebookads_get_custom_audience`

Get details for a specific custom audience

`ads_management`

Create Custom Audience`facebookads_create_custom_audience`

Create a new custom audience

`ads_management`

Update Custom Audience`facebookads_update_custom_audience`

Update an existing custom audience

`ads_management`

Delete Custom Audience`facebookads_delete_custom_audience`

Delete a custom audience

`ads_management`

List Lead Gen Forms`facebookads_list_leadgen_forms`

List lead generation forms for a Facebook Page

`pages_manage_ads`

Get Lead Gen Form`facebookads_get_leadgen_form`

Get details for a specific lead generation form

`pages_manage_ads`

Create Lead Gen Form`facebookads_create_leadgen_form`

Create a lead generation form for a Facebook Page

`pages_manage_ads`

List Leads By Ad`facebookads_list_leads_by_ad`

Get all leads for a specific ad

`leads_retrieval``pages_manage_ads`

List Leads By Form`facebookads_list_leads_by_form`

Get all leads for a specific form

`leads_retrieval``pages_manage_ads`

Get Lead`facebookads_get_lead`

Get details for a specific lead

`leads_retrieval``pages_manage_ads`

List Business System Users`facebookads_list_business_system_users`

List system users for a Business

`business_management`

Create Business System User`facebookads_create_business_system_user`

Create a system user for a Business

`business_management`

List System User Assigned Users`facebookads_list_system_user_assigned_users`

List users assigned to a system user

`business_management`

Get Me`facebookads_get_me`

Get the profile of the authenticated user. Retrieving the email field requires the `email` scope to be granted.

`public_profile`

Get User`facebookads_get_user`

Get the profile of a specific user. Retrieving the email field requires the `email` scope to be granted.

`public_profile`

List My Accounts`facebookads_list_my_accounts`

List the Pages managed by the authenticated user

`pages_show_list`

List User Accounts`facebookads_list_user_accounts`

List the Pages managed by a specific user

`pages_show_list`

List User Businesses`facebookads_list_user_businesses`

List the Business Manager accounts a user belongs to

`business_management`


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