Version 15.0

Graph API

Released September 15, 2022 | Available until November 20, 2024 | 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:

• POST /{page-id}/tabs
• DELETE /{page-id}/tabs

Marketing API

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:

• GET /{ad-account-id}/customaudiences?fields=operation_status
• POST /{ad-account-id}/adsets?fields=subtype
• POST /{ad-account-id}/customaudiences?fields=subtype
• POST /{ad-campaign-id}?fields=subtype
• POST /{custom-audience-id}

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:

• GET /{ad-account-id}/adsets
• POST /{ad-account-id}/adsets
• GET /{ad-set-id}?fields=targeting

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:

• GET /{ad-account-id}/adsets
• POST /{ad-account-id}/adsets
• GET /{ad-set-id}/delivery_estimate

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:

• POST /{ad_account_id}/campaigns

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:

• POST /{ad_account_id}/customconversions