Facebook Custom Audiences


A Facebook Custom Audience is a targeted advertising service that allows businesses to import user email addresses for retargeting on the social media platform.


  • Deliver precise targeting ads on Facebook with Facebook Custom Audience plugin, the plugin enables you to import your contact list into Facebook.
  • By importing contact list, you can effectively target people with ads that can easily increase conversions with every campaign.
  • We provide perfect synchronization of your social network (Facebook) with marketing system; this allows you to deliver right creative in front of the right people, at the right time, all the time, automatically.


  1. Require the FB ads library in the Mautic root directory Composer require facebook/php-ads-sdk:2.9.* The library has been tested on 5.6 to also work so if you get requirements errors try: Composer require –ignore-platform-reqs facebook/php-ads-sdk:2.9.*
  2. Create a new Facebook App: https://developers.facebook.com/apps/
  3. Add the Marketing API Product.
  4. Visit the Marketing API -> Tools page in your app and check the scopes and hit Get Token. Store this access_token for later use.
  5. Go into your Facebook Ads account management and get your ad account id.
  6. Visit the Marketing API -> Settings page in your app and add your ad account id.
  7. Visit the app Dashboard page and store the app_id and app_key for later use.
  8. Enable the plugin and enter your app_id, app_secret, access_token and ad accoun id. . If you have more than 10 segments you might get errors enabling the plugin on install. When your facebook App is in development mode the request rates are limited. Remove some segments en readd them later.
  9. Visit your facebook ads audiences page and check whether your segments have been added.
  10. Have your application running for a while. After you have reached 1000 successful API calls to your facebook app you can submit it for review and have proper rate limiting.