Version 15.0

Graph API

Released September 15, 2022 | Available until TBD | Blog post

Instagram Graph API

Story Webhooks

Applies to all versions.

Story insights webhooks notifications are now sent 1 hour after story expiration.

Pages API

Custom Page Tabs

Applies to v15.0+. Will apply to all versions December 14, 2022.

Custom Page Tabs are no longer available. The following endpoints are affected:

Marketing API

The expiration date for Marketing API v14.0 and v15.0 has been moved to September 20, 2023 from August 15, 2023 to provide more time for the platform integrating changes for DSA enforcement. Note v14.0 and v15.0 will expire on the same day. To avoid disruption to your apps, we recommend upgrading to our latest version before September 20.

Released September 15, 2022 | Available until September 20, 2023 | Blog post

Audiences

Special Ad Audiences

Applies to all versions.

Special Ad Audiences, which are similar to lookalike audiences for housing, employment, and credit advertisers, have been deprecated due to a settlement with the US Department of Housing and Urban Development. See the developer blog for more information about this announcement.

You can no longer create Special Ad Audiences. Special Ad Audiences endpoints will be removed no later than December 31, 2022.

The following endpoints and fields are affected:


Advantage Custom Audiences

Applies to v15.0+. Will apply to all versions on December 14, 2022.

When creating an ad set with any objective and with a non-data file custom audience in inclusion, Advantage custom audiences will be turned on by default.

When creating an ad set with a non-Advantage lookalike objective (that is, Value Optimization, Offsite Conversion, App Installs and Messages) with lookalike in inclusion, Advantage lookalike will be turned on by default.

Advantage custom audience and Advantage lookalike can be enabled or disabled through the targeting_relaxation_types targeting spec parameter. targeting_relaxation_types accepts either custom_audience and lookalike as a key, and if a value of 0 is passed, it will be disabled. If a value of 1 is passed, it will be enabled. If no key/value pair is passed, it will be considered as enabled.

The following endpoints and fields are affected:


Advantage Detailed Targeting

Applies to v15.0+. Will apply to all versions on December 14, 2022.

When creating an ad set with the Messages or App Installs optimization goals, Advantage lookalike and/or Advantage detailed targeting will be turned on by default and cannot be disabled.

When querying ad sets with the Messages or App Installs optimization goals that have Advantage detailed targeting and/or Advantage lookalike enabled, a targeting_optimization_types map will be returned with the detailed_targeting and lookalike properties indicating that the expansion is enabled. When querying delivery estimates for ad sets with the Messages or App Installs optimization goals, the targeting_optimization field will no longer be accepted and an error will be thrown.

For existing ad sets, you will be able to pass the targeting_optimization field.

The following endpoints are affected:

Campaigns

Deprecated optimization type

Applies to v15.0+. Will apply to all versions on December 14, 2022.

Beginning September 15, 2022, advertisers will no longer be allowed to create incremental conversion optimization campaigns. Existing conversion optimization campaigns will behave normally.

The following endpoint is affected:


Custom Conversions

Applies to v15.0+.

We now require new Custom Conversions to contain at least one rule when they are created. Otherwise, campaigns should optimize on the event directly.

The following endpoint is affected: