Changelog for Instagram Platform

This changelog refers to changes made for the Instagram APIs.

Related Changelogs

• Graph API Changelog
• Marketing API Changelog
• Messenger Platform Changelog (includes Instagram Messaging)

December 3, 2025

Accept/Decline Collaboration Invites

Applies to all versions.

Introducing Accept/Decline Collaboration Invites in Instagram API with Facebook Login on the IG User. The API provides the following capabilites:

• Query all the IG Media(s) where the app user's Instagram user has been invited for collaboration
• Accept/Decline a collaboration invite using media_id of the tagged IG Media

Endpoints

• GET /<IG_USER_ID>/collaboration_invites
• POST /<IG_USER_ID>/collaboration_invites

instagram_basic permission is required to access these endpoints.

Insights Metrics

Applies to all versions.

Introducing the following metrics fields for media insights:

• reels_skip_rate

• reposts

Introducing the following metrics fields for user insights:

• reposts

Additional views metric for Reels crossposted to Facebook:

• crossposted_views

• facebook_views

Currently, the IG Insights API only returns metrics native to Instagram. However, certain media type like Reels can be crossposted to Facebook, and the aggregation of the views on both platforms shows up on the native Instagram app. Now, crossposted_views returns the total number of views for reels that are crossposted to Facebook across both platforms. facebook_views returns the total number of views specifically from Facebook.

This change does not affect the Business Discovery API. For media accessed via this API, view_count will continue to reflect only Instagram views and will not include aggregated crossposted views.

Supporting Trial Reels in the Content Publishing API

Applies to all versions.

Introducing Trial Reels Support in Instagram API with Facebook Login and Instagram API with Instagram Login for the Content Publishing API.

trial_params is optional and part of the create media endpoint. Users will be able to specify a Trial Reel configuration to create and publish Trial Reels directly from the Instagram API.

November 10, 2025

We now support an Instagram Professional account messaging itself.

November 3, 2025

You can now send a collection of images in Instagram Direct. See the updated dev docs.

October 27, 2025

We are rolling out a change to add enhanced support for Instagram post shares in Instagram messaging webhooks.

September 23, 2025

Businesses can now display typing indicators and mark_seen indicators in a conversation to let message recipients know that the business has seen and are processing their message, using Sender Actions.

Sept 10, 2025

June 16, 2025

June 14, 2025

April 8, 2025

March 24, 2025

January 21, 2025

December 4, 2024

Instagram Basic Display API

Applies to all versions.

The Instagram Basic Display API has been deprecated. All requests to the Instagram Basic Display API will return an error message. We recommend that you migrate your app to the Instagram API to avoid any disruption to your services.

Visit our News for Developers blog post to learn more.

October 3, 2024

Welcome Message Flows now available for Instagram API with Instagram Login. Learn more.

October 2, 2024

September 17, 2024

New scope values

Applies to all versions.

To ensure consistency between scope values and permission names, we are introducing new scope values for the Instagram API with Instagram login. The new scope values are:

• instagram_business_basic
• instagram_business_content_publish
• instagram_business_manage_comments
• instagram_business_manage_messages

These will replace the existing business_basic, business_content_publish, business_manage_comments and business_manage_messages values, respectively.

Please note that the old scope values will be deprecated on January 27, 2025. It is essential to update your code before this date to avoid any disruption in your app's functionality. Failure to do so will result in your app being unable to call the Instagram endpoints.

Correction: Deprecation date moved from December 17, 2024 to January 27, 2025.

July 23, 2024

Launch of the new Instagram API with Instagram Login

Components of this new Instagram API:

• A Facebook Page will no longer be required
• The host URL for API calls is graph.instagram.com
• New permissions for this API:
  • instagram_business_basic
  • instagram_business_content_publish
  • instagram_business_manage_comments
  • instagram_business_manage_messages
• The Messenger API will no longer be used to send Instagram messages
• New apps will add the new Instagram product when creating a Meta app
• Existing apps can add the new Instagram product in the App Dashboard

Visit our migration guide to learn if this new Instagram API with Instagram Login is right for you.

June 11, 2024

Instagram Comment Webhooks

Applies to all versions.

In addition to the ad_id and ad_title, the original_media_id will be returned in the media object of the comments field's value object when a person comments on a boosted Instagram post or Instagram ads post. For more information, refer to Set Up Webhooks for Instagram.

May 21, 2024

September 12, 2023

November 9, 2022

Instagram Webhooks

Applies to all versions.

The ad_id and ad_title will be returned in the media object of the comments field's value object when a person comments on a boosted Instagram post or Instagram ads post.

October 31st

Reels – Product Tags

Applies to all versions.

Instagram Product Tagging API for Reels is made available. You can tag up to 30 products when publishing a reel.

June 28, 2022

June 27, 2022

June 20, 2022

May 27, 2022

Product Variants

Applies to all versions.

For partners in the Product Tagging beta, all product variants that match a query's search criteria will now be returned when searching a catalog for products.

March 15, 2022

November 9, 2021

October 20, 2021

October 5, 2021

June 8, 2021

Like Counts

Applies to v11.0+. Will apply to all versions September 7, 2021.

If indirectly querying an IG Media through another endpoint or field expansion, the like_count field will be omitted from API responses if the media owner has hidden like counts on it. Directly querying the IG Media (which can only be done by the IG Media owner) will return the actual like count, however, even if like counts have been hidden.

Time-based Pagination

Applies to v11.0+.

Added since and until parameters to the GET /{ig-user-id}/media endpoint to support time-based pagination.

May 26, 2021

May 4, 2021

April 14, 2021

April 12, 2021

Fixed a minor bug with reach metrics on story IG Media.

April 9, 2021

March 16, 2021

IGTV media is now supported in v10.0+. This applies to all endpoints except those used for content publishing and webhooks. To support this change, new media_product_type and video_title fields have been added to the IG Media node. IGTV media must have been shared to Instagram at the time of publish (Post a Preview or Share Preview to Feed enabled) in order to be accessible via the API.

Januray 26, 2021

The Content Publishing beta has ended and all developers can now publish media on Instagram Professional accounts. Refer to the Content Publishing guide for usage details.

December 2, 2020

In compliance with the European Union's ePrivacy Directive, messaging-related Story IG Media interactions performed by users in the European Economic Area (EEA) after December 1, 2020, will no longer be included in some metric calculations:

• For Stories created by users in the EEA, the replies metric will now return a value of 0.
• For Stories created by users outside the EEA, the replies metric will return the number of replies, but replies made my users in the EEA will not be included in its calculation.

This change applies to all versions.

November 10, 2020

• IG User Insights — The follower_count values now align more closely with their corresponding values displayed in the Instagram app. In addition, follower_count now returns a maximum of 30 days of data instead of 2 years. This change applies to v9.0+ and will apply to all versions May 9, 2021.

May 5, 2020

• Hashtag Search — This change applies to v7.0+ — You can now request the timestamp field on IG Media returned by GET /{ig-hashtag-id}/top_media and GET /{ig-hashtag-id}/recent_media Hashtag Search queries. For example: GET /{ig-hashtag-id}/top_media?fields=timestamp.

December 3, 2019

• Insights — To align API behavior with Instagram app behavior, insights on IG Users are now only available on IG Users that have 100 or more followers.

August 13, 2019

• Business Discovery — The Business Discovery API can now be used to get data about other Instagram Creator accounts.

May 22, 2019

• Instagram Creator Accounts — The API now supports Instagram Creator Accounts, with two exceptions. (1) The Content Publishing API cannot be used by Instagram Creators, and (2) the Business Discovery API can be used by Creators but can only target Businesses.

May 9, 2019

• Webhooks — The story_insights field now requires the instagram_manage_insights permission instead of instagram_manage_comments.

October 31, 2018

• Hashtag Search API — You can now search for media tagged with specific hashtags by using our new Hashtag Search API. #spooky!

October 23, 2018

• /{ig-media-id}/comments edge — GET requests made using API version 3.1 or older will have results returned in chronological order. Requests made using version 3.2+ will have results returned in reverse chronological order.

June 7, 2018

• /{ig-media-id} node — You can now use field expansion to get the permalink field on media objects.

May 1, 2018

• Business Verification — In order to use the Instagram Graph API, all apps must undergo Business Verification, which is part of the App Review process and now required for all Instagram Graph API endpoints. Apps previously reviewed before May 1st, 2018, have to be reviewed again, and have until August 1st, 2018 to do so, or lose access to the API.

April 24, 2018

• /{ig-comment-id} node:

  • Added a new username field.
  • For GET requests, the user field will not be included in responses unless the User making the request owns the Comment; instead, we will return username for all commenters. This also applies to queries on Comments made through other APIs, such as the Mentions API.
• /{ig-media-id} node:

  • Added a new username field.
  • For GET requests, the owner field will not be included in responses unless the User making the request owns the media object; instead, we will return username for all commenters. This also applies to queries on media objects made through other APIs, such as the Mentions API.

April 23, 2018

• Insights API — Insights will now include ad activity generated through the API, Facebook ads interfaces, and Instagram's Promote feature. This affects the following metrics:

  • impressions
  • reach

March 13, 2018

• Content Publishing API — Beta partners can now use the /{ig-user-id}/media edge to tag locations and public Instagram users when publishing photos.

March 8, 2018

• Public fields — The timestamp field on the /{ig-media-id} node is now a public field and can be returned via field expansion.

February 22, 2018

• Public fields — The /{ig-user-id}, /{ig-comment-id}, and /{ig-media-id} nodes will now return all public fields when accessed through an edge via field expansion. Refer to each node's reference document to see which fields are public.

February 8, 2018

• Content Publishing API — Beta partners can now include hashtags when publishing photos via the /{ig-user-id}/media edge. #crazywildebeest FTW!