Instagram Messaging
Changelog
Updated: May 6, 2026
Get notified
Changelog (39)
May 6, 2026

Sending multiple images is now out of beta and available to all accounts via Facebook Graph API for Instagram accounts linked with a Facebook page OR the Instagram API for Instagram-only accounts.
Apr 27, 2026

The legacy share attachment type is being removed from Instagram post share webhook payloads. As announced on October 30, 2025, the share attachment has been deprecated in favor of the ig_post attachment type, which includes full metadata (media ID, URL, and title). This change is being rolled out gradually: webhooks will return only the ig_post attachment once rollout reaches your app. If your integration still relies on the share attachment type for Instagram posts, update it to use ig_post instead or contact our developer support team through Meta Developer Support Portal to request exclusion of your app(s) from this change.
Mar 13, 2026

The Instagram Direct Send API now supports sending the images with attachment IDs (in addition to image URLs) which resolves the problem of timeouts when uploading multiple large high-quality images from slow servers. You can use the attachment API to upload the images one at a time and reuse the attachment IDs to send the same image to multiple users. See the updated documentation for Facebook Graph API for Instagram accounts linked with a Facebook page OR the Instagram API for Intagram-only accounts.
Dec 19, 2025

Instagram PDF Attachments

You can now upload and send PDF file attachment in Instagram Direct using Facebook Graph API for Instagram accounts linked with a Facebook page OR the Instagram API for Instagram-only accounts.

Instagram Message Replies API

You can now send a reply to a specific message in Instagram Direct using the Facebook Graph API for Instagram accounts linked with a Facebook page
reply_to object will also be available in the Conversations API. It will be non-null when the message is a reply and will indicate if it is a self reply. This boolean flag will also be added to the reply_to object returned in the message object in Message and Echo webhooks.
Dec 2, 2025

Businesses can now use the Messenger and Instagram Send API to react with a reaction emoji to a message in their inbox, edit an existing reaction on a message and remove a reaction (unreact) from a message that was previously reacted to.
Nov 3, 2025

You can now send a collection of images in Instagram Direct using either the Facebook Graph API for Instagram accounts linked with a Facebook page OR the Instagram API for Intagram-only accounts.
November 3, 2025: Multi-image sending is a Beta feature that will be rolled out incrementally over a few weeks . While the feature is rolled out, some Instagram accounts may get an error response 2534068 to indicate that the feature is not yet available for that account.
Oct 30, 2025

Starting November 3, 2025, the webhook payload for Instagram post shares will include two attachments: the existing share attachment and a new ig_post attachment. The payload now provides additional metadata, including media ID, URL, and title (caption).
If this change is not compatible with your app and you need more time to make updates, please contact our developer support team via the Meta Developer Support Portal to request exclusion of your app(s) from this change until you make the necessary updates to support the new attachment type.
The old share attachment type will continue to be supported for Instagram posts until February 1, 2026, after which it will be removed. Partners and integrators are encouraged to migrate to the new ig_post attachment type as soon as possible. See here for before and after payload sample.
Oct 23, 2025

Meta no longer supports the Handover Protocol for Instagram. All businesses have been migrated to Conversation Routing. Conversation Routing is backwards compatible with most Handover Protocol APIs and functionalities, and is expected to function without interruption.
Oct 21, 2025

Instagram Moderate Conversations API is now available. This new API will allow businesses to block users, unblock users, and move conversations to the spam folder in Meta Business Suite Inbox for the Instagram platform. Previously, these actions could only be completed on the Instagram app or Meta Business Suite.
Oct 13, 2025

The Conversations API now supports an is_owner field for both Messenger and Instagram. This field indicates if the app making the request is the current thread owner of the conversation or not, and is only returned when Conversation Routing is enabled.
Benefits:
  1. Filter and respond only to conversations your app owns.
  2. Avoid unnecessary ticket creation and reduce costs.
  3. Streamline recovery after downtime by focusing on relevant threads.
Sep 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.
Sep 16, 2025

Custom thread control window for Click To Instagram Ads is now available. When a conversation starts from an ad, the app controls the thread for 24 hours from the last user message, extendable up to 30 days by setting receiving_app_control_expiration. Invalid values or Conversation Control actions reset the window to 1 day.
Sep 10, 2025

Introducing the new message_edit webhook subscription in Instagram supporting both use cases of both Business Login for Instagram and Facebook Login for Business. Sample message_edit webhook can be found here.
Feb 24, 2025

Messenger and Instagram

messaging_referrals webhook now contains flow ID. The webhook event contains a flow_id field when an ad referral originates from an ad with a Welcome Message flow. This is available in the ad referral object of the messages, messaging_postbacks, messaging_referrals webhooks. See more details about the webhook here.
Oct 8, 2024

Messenger response_feedback webhook

The new response_feedback webhook event notifies you when a user provides feedback on a message you send, by clicking on one of the “thumbs up”/”thumbs down”/”Good response”/”Bad response” buttons. See more details about the webhook here.

Send API Rate Limits

Your app can now make 300 (up from 100) calls per second per Instagram professional account for messages that contain text, links, reactions, and stickers. Learn more.
Jun 23, 2024

Launch of the new Instagram API with Instagram Login

  • 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_publishing
    • instagram_business_manage_comments
    • instagram_business_manage_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
Monitor the Instagram Platform Changelog for changes including bug fixes and new features
Jun 11, 2024

Messenger Messages Webhook

ig_reel will now be a supported attachment type for the messages webhook. IG reel attachments will have type ig_reel and the attachment payload will include the title, url, and video id for the reel.

Instagram Messages Webhook

ig_reel and reel will now be supported attachment types in a messages webhook. IG reel attachments will have type ig_reel, and the attachment payload will include the title, url, and video id for the reel. FB reel attachments will have type reel, and the attachment payload will include the title, url, and video id for the reel.

Messenger Conversation Routing: app-level thread control configs

Businesses using Messenger Conversation Routing can now configure the thread control takeover capability on the individual app level. The original takeover config that’s coupled with the default app is now deprecated with all values migrated. Learn more here.

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.
Mar 12, 2024

Welcome Message Flows

Welcome Message flows can now be configured for messaging ads using the marketing API. Learn more about Click to Messenger ads here and Click to Instagram ads here.
Oct 17, 2023

Conversation Routing for Instagram

Conversation Routing is now available for Instagram. Conversation Routing allows Meta to route conversations between your business and customers, or prospective customers, to the app that you have specified to respond in the conversation. This routing allows your business to create rich conversations with people and to minimize API calls to Meta’s servers.

Custom Labels and Personas APIs

The Custom Labels API and Personas API access has been restored to businesses that operate in Europe, and for people in Europe and Japan who connect with businesses globally.

Updates to welcome message flows for Ads that Click to Messenger and Instagram Direct

Businesses and agencies can now easily connect their Click to Messenger and Click to Instagram Direct ads to a welcome message created in a partner app without having to use a JSON code snippet. The welcome message will appear as a dropdown in ads manager when creating the Click to Messenger and Click to Instagram Direct ad. Learn more about it here.
Sep 12, 2023

Conversation Routing

As a business, you may use multiple third-party messaging providers for different conversations with your customers, like lead generation, marketing offers about your products, or customer support questions. Conversation routing lets you define which partners control customer conversations at a particular time, so that customers get the information they need. You can create and manage message routing rules in your Page settings.

Button Template for Instagram

The button template sends a text message with up to three attached buttons. This template is useful for offering the message recipient options to choose from, such as predetermined responses to a question, or actions to take. Supported button types are postback and web_url.
Jun 20, 2023

Instagram Messaging with the Messenger Platform

Instagram Messaging is now available for any Instagram Professional account for a business or a Creator.
Jun 15, 2023

Ads that Click to Messenger

Call Prompt

You can now add a call prompt to allow customers or people interested in your business to call your business.

Click to Subscribe

You can now create ads that include a click to subscribe flow that allow you to ask customers or people interested in your business to opt in to receiving marketing messages.

Multi App Routing

Multi App Routing is now available for Instagram Direct and Messenger.
Feb 21, 2023

Recurring Notifications for Messenger Platform

Titles for Opt In Request

The title property for recurring notification opt in requests is no longer required. If title is not set, the value defaults to “Updates and promotions”. This change applies to opt in requests sent from a Facebook Page or Instagram Professional accounts.
Feb 2, 2023

Recurring Notifications for Messenger Platform

Message Frequency for Opt In Requests

The notification_messages_frequency property for recurring notification opt in requests is deprecated and will no longer be returned in GET requests or webhook notifications. However, notification message tokens created before Feb. 2, 2023 for weekly or monthly recurring notifications will be supported and the notification_message_frequency will be returned in webhook notifications.

Followup Messages for Opt Ins

You can now send up to three followup messages to a person who has opted in to receiving recurring notifications. All three followup messages must be sent within 2 minutes of the first followup message.

Notification Message Tokens

The GET /PAGE-ID/notification_message_tokens endpoint is now available for Instagram Messaging.
The next_eligible_time property for Notification Message Token endpoints is now available. This field returns the time at which you are able to send the next recurring notification using that notification message token.
Messenger API for Instagram
You can now send GIFs in messages sent from an Instagram Professional account using the Messenger API for Instagram.
The Attachment Upload API now supports uploading media for messages sent from an Instagram Professional account.
Referral information for ads that click to an Instagram conversation (CTD) is now returned in messages webhook notifications.
Nov 9, 2022

Business Login for Instagram

Business Login for Instagram makes it easier for you to onboard Instagram users who still need to configure their account for API access through modal pop ups and fewer steps.

Improvements between Click to Messenger, Lead Gen ads and Messenger Platform

We’ve made following up on Lead Gen ads that Click to Messenger easier through:
  • A new Referral Webhook for Click to Messenger, Lead Gen ads that include the lead information.
  • Improvements to the Handover Protocol. Advertisers can now select which app they want to route completed leads. Additionally, for apps that haven’t yet implemented these app notifications, an optional summary message can be enabled, to send lead information to that app in the form of a regular message.
  • Since referral or summary events are triggered while the standard messaging window is open, apps can use this to follow-up with leads directly in Messenger, upsell them to Recurring Notifications or have them book an appointment or call the business directly.

Messaging Events API

Messaging Events API supports the lead_submitted event. Businesses can use this event to report lead submissions from Click to Messenger ads. This new messaging event is released as an Open Beta. Reporting in Ads Manager will come soon.

Persistent Menu

Persistent Menu is now available for Instagram Messaging.

Private Replies

Instagram Messaging now supports Private Replies for comments on Instagram Live Stories and ads posts. You may need to update your webhooks server to handle these new fields.

Recurring Notifications

You can now get a list of all valid Notification Message Tokens using the GET /PAGE-ID/notification_message_tokens endpoint.
Aug 16, 2022

Private Replies

Private Reply is now available for comments on Instagram Reels.

Instagram Messaging

You can now send Instagram messages with audio and videos that have been uploaded to a Meta server or sent from your server.
May 25, 2022

User Profile API supports retrieval of the customer’s Instagram username field on Graph API v14.0 and later.
May 19, 2022

Recurring Notifications for Messenger API
Recurring Notifications is a major update to the Messenger API to allow businesses to send proactive, automated messages that drive re-engagement. Recurring Notifications help businesses deliver personalized, customer centric messages at every stage of the customer journey.
Recurring Notifications for Messenger API for Instagram
We’re announcing Recurring Notifications for Messenger API for Instagram as a beta. Developers can sign up for our beta interest list before July.
Instagram Send API rate limit increase
We have increased the rate limit for the Send API to 100 API calls per second for each Instagram Professional Account.
ig.me referral parameter
Businesses can add ig.me links on websites, emails, and product packaging to easily enable users to start a conversation with a business on Instagram. We are adding the ability for brands to add a referral parameter to these ig.me links to create personalized messaging experiences.
Instagram API New Onboarding Flow
We are announcing a new onboarding flow for the Instagram API as a beta. Developers can sign up for our beta interest list before June 29.
Mar 15, 2022

We have launched the Persistent Menu for Messenger API support for Instagram. This enables users to discover and interact with a Page’s main features.
Nov 11, 2021

Messenger API for Instagram is now available for Instagram Creators account type with less than 500K followers. Please see details in the developer documentation.
Nov 9, 2021

Oct 20, 2021

  • IG comments webhook and API are updated with additional fields. Please refer to the developer documentation for more details on new fields.
  • Starting support for IG.me link, a shortened URL service that directs users to messaging experience on Instagram. Developers can use the link format https://ig.me/m/{ig_profile_handle} on website, email, and more. Please refer to the developer documentation for more details.
  • We have made updates to the Ice Breaker on Instagram to support multiple versions in different languages. Developers can now set up Ice Breakers in different languages and serve the right version to users based on user locale. Please refer to the developer documentation for more details.
Sep 14, 2021

  • Handover Protocol Improvements
  • Custom Labels API - We are making exciting updates to the Custom Labels API that would allow businesses to create, update and delete labels and sync the labels between the Facebook Page Inbox and any other tool the business might be using to communicate with their customers.
    1. In order to use the Custom Labels API after October 1st, 2021 businesses need to accept our new Page Contact Terms. These terms describe Meta’s data practices for the Custom Labels created by the business. We will be rolling out the Page Contact Terms acceptance requirement to Facebook Pages on a rolling basis starting October 1st.
    2. Graph API v12.0+ Custom Labels API name field will be replaced with page_label_name. This change will take effect on all older Graph API versions starting Dec 14, 2021. Developer should leverage page_label_name across various CRUD (Create, Retrieve, Update, Delete) API calls and webhooks.
  • Messenger API Updates for Europe and Japan - We have restored Customer Feedback Template in the Messenger API that wasn’t available to businesses in Europe, and for people in Europe and Japan who connect with businesses globally. Details here.
  • Messenger API for Instagram updates
    • Reaction Webhook - We have updated emoji reactions to return a new unicode format and support multiple emoji reactions. Please refer to the developer documentation and migrate to the new version before December 14, 2021 in order to continue supporting emoji reactions.
  • User Profile API - We have updated User Profile API to include additional fields that are publicly available on the Instagram app. Please refer to the developer documentation for details.
  • IGID Deprecation - Conversation API will no longer return IGID field and fully rely on IGSID field. See developer documentation for details in order to migrate before December 14, 2021.
  • Facebook Chat Plugin Customization API - We are launching Chat Plugin customization settings through API. With this new release, developers will be able to edit features including the position, color, greetings, guest mode settings, etc. that are currently only available using our first-party tools today.
  • Message Echo webhook will now include the app id for Facebook Page Inbox as part of Graph API v12.0 - When a business responds to a Messenger conversation from Facebook Page Inbox, other apps connected to the Page can listen to the Message Echo webhook. These apps will receive an echo webhook with the Facebook Page inbox app id (263902037430900).
Aug 16, 2021

  • Messenger API for Instagram- Messenger API for Instagram opened up to all developers in June, with an opportunity to build for IG business accounts with follower counts between 10k-100k. Now, developers can add Instagram messaging into their apps and build Instagram messaging experiences for all businesses on Instagram. The use of Messenger API for Instagram must comply with the Developer Policies, particularly the policies listed under ‘Messenger and Instagram Messaging APIs’, as well as the technical documentation.
Aug 6, 2021

  • Private Replies on Instagram Messaging API no longer need to be sent using the Human Agent Message Tag. Private Reply API calls with the Human Agent Tag will stop working after Sept 13, 2021.
Jul 7, 2021

  • Messenger API for Instagram - Messenger API for Instagram opened up to all developers in June, with an opportunity to build for IG business accounts with follower counts between 10k-100k. We are expanding the rollout to IG business accounts with follower counts between 1K-10K. Now, developers can add Instagram messaging into their apps and build Instagram messaging experiences for even more businesses. The use of Messenger API for Instagram must comply with the Developer Policies, particularly the policies listed under ‘Messenger and Instagram Messaging APIs’, as well as the technical documentation.
Jun 22, 2021

  • Generic Templates, which allows you to send a structured message that includes an image, text and buttons, is now available for Instagram
Jun 8, 2021

The following changes apply to v11.0+
  • Adding <mid> to messaging_postback events for Messenger and Messenger API for Instagram for Graph API V11.0+ - We are adding the Message Id (<mid>) field as part of the messaging_postback payload to help reduce engineering overheads for our partners who have had to rely on the Conversations API to fetch conversation history and then compare it with the webhook events. See more details here.
  • Airline Templates are deprecated - Airline Templates will no longer be supported starting Graph API v11. Deprecation for the prior versions of the Graph API will occur 6 months after the announcement of this change on Dec 6, 2021. We recommend airlines send Boarding Pass and Check-in templates as images which are consistent with how they typically send these notifications in other channels.
Jun 2, 2021

  • Messenger API for Instagram - We have opened up the Messenger API for Instagram to all developers who are making it possible for brands to offer messaging experiences on Instagram at scale. Now, developers can add Instagram messaging into their apps and build experiences for Instagram messaging. Developers can help businesses use different applications to leverage existing workflows, drive more meaningful conversations, increase customer satisfaction, and grow sales. Learn more here. The use of Messenger API for Instagram must comply with the Developer Policies, particularly the policies listed under ‘Messenger and Instagram Messaging APIs’, as well as the technical documentation.
  • Human Agent message tag now available to all developers - This tag allows businesses to respond to user messages on Messenger and Instagram manually outside the 24-hour standard messaging window up to 7days. This tag is helpful especially for use cases such as weekend closures or for inquiries that need more than 24 hours to resolve. Developers should apply for the Human Agent tag permission via the App dashboard even if your app has been previously approved for Human Agent message tag. Navigate to the “Permissions and Features” section of the app dashboard and apply for the “Human Agent” permission. Learn more here.
  • Customer Feedback Template is now available as Beta - We are launching a native template within Messenger that supports common survey formats such as CSAT (Customer Satisfaction), NPS (Net Promoter Score), CES (Customer Effort Score) and free form text. The native template is easier to integrate because it’s built on Send API, eliminates the need to build custom survey solutions using Webview and makes it easy for developers to aggregate scores across channels that use similar survey formats. Learn more here.