Version 13.0

Graph API

Released February 8, 2022 | Available until TBD | Blog post

Instagram Graph API

IG Media

Version 13 will be the last version to allow video_title field requests on IG Media without returning an error. As a reminder, the current API behavior outlined in our October 5th, 2021 blog post is as follows:

media_product_type field returns FEED for all versions
video_title field is omitted from responses for all versions
Instagram Webhooks comments and mentions fields are supported for all versions

The behavior above applies to all IG Media, including IG Media created with the Instagram TV app, regardless of creation date.

User Insights

Applies to v13.0+

The following IG User Insights metrics no longer support since and until parameters, and responses will not include the end_time JSON property.

Marketing API

Released February 8, 2022 | Available until January 25, 2023 | Blog post

Ad Creative

Placement Asset Customization Ads

Applies to v13.0+.

The asset_feed_spec node of the POST /{ad-account-id}/adcreatives endpoint will now allow the creation of carousel ads with Placement Asset Customization ads.

Ads Library API

Ads Archive

Applies to v13.0+.

The following query edges and fields on the GET /ads_archive endpoint have been deprecated and replaced:

Old Edge/Field	New Edge/Field
`funding_entity`	`bylines`
`region_distribution`	`delivery_by_region`
`potential_reach_min`	`estimated_audience_size_min`
`potential_reach_max`	`estimated_audience_size_max`
`potential_reach`	`estimated_audience_size`

The following return parameters on the GET /ads_archive endpoint have been deprecated and replaced:

Old Edge/Field	New Edge/Field
`ad_creative_body`	`ad_creative_bodies`
`ad_creative_link_caption`	`ad_creative_link_captions`
`ad_creative_link_description`	`ad_creative_link_descriptions`
`ad_creative_link_title`	`ad_creative_link_titles`
`funding_entity`	`bylines`
`region_distribution`	`delivery_by_region`

Ad Sets

Lookalike Expansion

Applies to v13.0+. Will apply to all versions May 9, 2022.

For newly created ad sets that optimize for value, conversions, or app events, lookalike expansion will be turned on by default and cannot be disabled. When getting an ad set that optimizes for value, conversions, or app events, we will return a new lookalike property in the targeting_optimization_types map that indicates lookalike expansion is enabled and complements the existing detailed_targeting property for the detailed targeting expansion.

This change affects the following endpoints:

Conversions API

Customer Information Parameters

Applies to v13.0+.

There are new requirements for the combinations of customer information parameters that are considered valid for an event. An event will be considered invalid if it only includes parameters consisting of one of the following combinations or a subset thereof:

ct + country + st + zp + ge + client_user_agent
db + client_user_agent
fn + ge
ln + ge

To ensure your events do not throw an error, we recommend that you review the Conversions API Best Practices.

This change affects the following endpoints:

Commerce Platform

Shipping Profiles API

Applies to v13.0+.

The handling_time field of the GET /{cms-id}/shipping_profiles endpoint has been moved from the shipping_profile object to the address_category object.

Catalog

Feed API

Applies to v13.0+.

The product feed upload error code XML_JUNK_AFTER_DOCUMENT has been renamed to DATA_OUTSIDE_XML_TAGS. This is a name change only.

The following endpoint is affected:

GET /{feed_upload_session_id}