News for Developers

Back to News

New Marketing API Requirements for all Advertising Campaigns

We’re committed to protecting people from discrimination on Facebook and, as part of this commitment, we announced changes earlier this year to all ads that offer housing, employment and credit opportunities.

Advertisers, developers and partners must specify whether or not their ads fall under either the category of housing, employment or credit. They can do so by selecting a Special Ad Category, and once a category is selected in Ads Manager or via the Marketing API, a limited set of targeting options will then be available.

Last month, we began rolling out these updates in Ads Manager. In September, the Special Ad Category fields will be available in the Marketing API. All developers that want to create ads must implement the Special Ad Category flows by Dec. 4, 2019, or their ads may be paused for non-compliance.

Important information for developers using the Marketing API:

All advertisers and developers using the Marketing API must take action by Dec. 4, 2019 by including the Special Ad Category field in the campaign creation calls:

  • Developers and advertisers that are located in the US or targeting users in the US and running ads with housing, employment and credit opportunities must specify their respective category.
  • Developers and advertisers that are located in the US or targeting users in the US and whose ads do not fall under one of the categories must specify NONE or the campaign creation requests will fail.
  • Developers and advertisers that are located outside the US whose ads target users outside of the US, regardless of the category, should specify NONE as well.

With Special Ad Category campaigns, some detailed targeting options, which may include demographics, behaviors or interests, will be unavailable, and advertisers will not be allowed to exclude detailed targeting options.

Important dates for developers:

  • Sept. 16, 2019: Special Ad Category features will be made available, and developers should begin implementing the above changes ahead of time to avoid any interruptions.
  • Dec. 4, 2019: All new campaigns must comply by this date, or these campaigns will no longer continue to run.
  • Starting in 2020, advertisers and developers will be required to modify any ongoing campaigns that began prior to Dec. 4 to comply with the new requirements.

Next steps for developers:

  • Review our Marketing API documentation to understand what changes need to be made. If you’re running an ad in the Special Ad Category, you will need to make additional updates to your campaigns:
  • Implement the Special Ad Category flow when it becomes available on Sept. 16. You will have until Dec. 4 to make the necessary changes.