Troubleshooting the Facebook Custom Audiences Integration

If someone is suppressed in my Klaviyo list, will this person still sync to my Facebook Custom Audience?

Yes. If Person A is suppressed in a Klaviyo list or segment, and you sync this list or segment to a custom audience, Person A will still sync to your Facebook audience. If someone is synced to a custom audience through Klaviyo, and then becomes suppressed in Klaviyo, this person will not be removed from your audience. While individuals may opt-out from email communications, you can still strategically reach these customers or subscribers through Facebook advertising leveraging Klaviyo's integration.

What if someone in my Klaviyo list/segment does not have a Facebook account associated with the email address I have recorded?

When you sync any given Klaviyo list or segment to a Facebook Custom Audience, it is likely that a % of the email addresses you attempt to sync will not match with an existing Facebook account. This is why your Facebook Custom Audience size may be smaller than the linked list or segment in Klaviyo. Facebook will not return an error, but won't add any contacts who have email addresses that don't match to an existing Facebook account.

I don't see all of my audiences on the list when prompted to select one to sync.

There are different Custom Audience data sources that Facebook accepts. Facebook won't allow us to sync with audiences that were created from the following sources:

  • WEB_PIXEL_HITS: Events reported by Facebook pixels on websites
  • WEB_PIXEL_COMBINATION_EVENTS: A composite audience of one or more inclusion and exclusion audiences, e.g. an audience of people who have viewed the homepage but not completed the signup process
  • MAIL_CHIMP_EMAIL_HASHES: Created from emails imported from MailChimp

Since we aren't able to sync with these audiences, we won't show them on the list of available audiences when you attempt to sync a list or segment in Klaviyo.

My Facebook Audiences integration got disabled and I don't know why.

There are two main reasons why a Facebook Audiences integration might be disabled:
  • There was an authorization error
  • An action was taken in Facebook that disrupted the integration

Regarding authorization, your integration will disable due to a permissions error if you update settings in your Facebook Ads account that cause our authentication token to get revoked (i.e. if you update account password). This can also happen if different users are manipulating audiences and these users don't have full admin permissions.

There are also certain actions you can take in Facebook that will disrupt the integration and cause it to disable. A common example is if you delete an audience in Facebook that we are actively trying to sync with. Our integration will disable if we attempt to sync with a deleted audience because we can’t determine why we can’t sync with the audience; we default to assuming there is a permissions issue and an authentication error is triggered.

If you see that your integration is disabled and you aren't sure why, the best thing to do is simply re-enable the integration in Klaviyo. If your integration repeatedly disables, consider the activity you or others with access to your Ads account might be taking that could disrupt the integration. You can always shoot us an email so we can help troubleshoot!

I'm being prompted by an error message to accept Facebook's Custom Audience Terms of Service.


If you see an error message saying that you need to accept Facebook's Custom Audiences Terms of Service, you will also see a clickable link. This link will be one of the following:

  • If your Ads Account is directly associated with your personal Facebook account:
  • If your Ads Account is within Business Manager:

If your Ads account is directly associated with your personal Facebook account, before you click this link, you need to ensure you are already logged into your Facebook Ads account.

The link you see in Klaviyo will take you to the Terms of Service (ToS) page for whichever Facebook account you are already logged into. You will need to accept these terms from within your Ads account to resolve this issue. To ensure you are accepting the ToS for the right Ads account, reference the drop-down menu in the upper left-hand corner:

If your Ads account is withing Business Manager, first navigate to this Ads account within Business Manager by starting in your Business Manager account and clicking Ad Account Overview in the upper left.  

Towards the bottom of the next window, click on the Ads account that you are trying to integrate with Klaviyo.

Once within Ads Manager:

  • Start a new campaign
  • When you get to the Audience step, under Custom Audiences, click Create New
  • Choose Customer File, and then Choose a file or copy and paste data
  • In the next window, at the very bottom, you will see: "I agree to the Facebook Custom Audiences Terms". Click this blue hyperlinked text.


You will then be brought to a window where the URL is:

Accept the terms of service here. If you fill in your own account values for ACCOUNT_ID and BUSINESS_ID in the URL above, you can also choose to navigate there without going through the steps outlined above.

Was this article helpful?
2 out of 3 found this helpful