Skip to content

Facebook Audience export

The Braze and Facebook integration allows you to manually export your Braze users Segments to Facebook to create Facebook Custom Audiences. This is a one-time, static audience export and will only create new Facebook Custom Audiences.

Common use cases for exporting Facebook Custom Audiences include:

  • Retarget users at specific points within their lifecycle
  • Create exclusion targeting lists
  • Lookalike Audiences to acquire new users more efficiently


Requirement Description
Facebook Business Manager A centralized tool to manage your brand’s Facebook assets (e.g., ad accounts, pages, apps).
Facebook ad account An active Facebook ad account tied to your brand’s business manager that you want to use Braze custom audiences with.

Ensure that your Facebook business manager admin has granted you admin permissions to the Facebook ad accounts you plan to use with Braze, and that you have accepted your ad account terms and conditions. Otherwise, you will not be able to access any Facebook ad accounts within Braze.
Facebook Custom Audiences Terms You must accept Facebook’s Custom Audiences Terms for your Facebook ad accounts you plan to use with Braze.


Connect to Facebook

In the Braze dashboard, go to Partner Integrations > Technology Partners and select Facebook.

In the Facebook Audience Export module, click Connect Facebook.

Facebook technology partners page in the Braze platform.

A Facebook oAuth dialog window will appear to authorize Braze to create Custom Audiences into your Facebook ad accounts.

The first facebook dialog box prompting to "Connect as X", where X is your Facebook username. The second Facebook dialog box prompting for permission to manage ads for your ad accounts.

Once you have linked Braze to your Facebook account, you will then be able to select which ad accounts you would like to sync within your Braze workspace.

A list of available ad accounts you can connect to Facebook.

Once you have successfully connected, you will be taken back to the partner page, where you can view which accounts are connected and disconnect existing accounts.

An updated version of the Facebook technology partners page showing the ad accounts successfully connected.

Your Facebook connection will be applied at the Braze workspace level. If your Facebook admin removes you from your Facebook Business Manager or access to the connected Facebook accounts, Braze will detect an invalid token. As a result, your active Canvases using Facebook audience steps will show errors, and Braze will not be able to sync users.

Exporting your users into Facebook

Braze’s Facebook audience export is accessible through the Segments page. Click on the gear next to the segment you’d like to export. Then click on Export as Facebook Audience.

A list of Braze segments. For the first segment, the setting symbol is selected and the "Export as Facebook Audience" button is shown.

If you haven’t already activated Facebook within Braze, it will prompt you to go to the Facebook Technology Partners page in the dashboard. If you have already activated Facebook through Technology Partners > Facebook, you will be able to select the user field to export, and a dropdown to select your Facebook ad account will show.

There are three possible user fields you can export:

  • Email
  • Device IDFA
  • Phone number

Once you have selected the user field, click on the Export button. Like CSV exports, you will receive an email when the segment has finished exporting into Facebook.

You can view the custom audience on the Facebook Ads Manager.

Configure your audience export

When building Facebook audiences, you may wish to include or exclude certain users based on their preferences, and in order to comply with privacy laws, such as the “Do Not Sell or Share” right under the CCPA. Marketers should implement the relevant filters for users’ eligibility within their Canvas entry criteria. Below we list some options.

If you have collected the iOS IDFA through the Braze SDK, you will be able to use the Ads Tracking Enabled filter. Select the value as true to only send users into Audience Sync destinations where they have opted in.

If you are collecting ‘opt-ins’, ‘opt-outs’, ‘Do Not Sell Or Share’ or any other relevant custom attributes, you should include these within your Canvas entry criteria as a filter:

A Canvas with an entry audience of "opted_in_marketing" equals "true".

Lookalike Audiences

Once you’ve successfully exported a segment as a Facebook Audience, you can create additional groups using Facebook’s Lookalike Audiences. This feature looks at your chosen audience’s demographics, interests, and other attributes and creates a new audience of people with similar attributes.

New Stuff!