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.post
, ig_post
, reel
, ig_reel
) with url, title and idpost
, ig_post
, reel
, ig_reel
)appointment_booking
attachment with status, start/end times, and timezone when fetching
conversation messages.appointment_booking
.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.2534068
to indicate that the feature is not yet available for that account.share
attachment and a new ig_post
attachment. The payload now provides additional metadata, including media ID, URL, and title (caption).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.shares
message field
is specified. The response provides both the stickerID and url for the AI generated sticker in the message.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.reply_to
is now available in the Conversations API
. It will be non-null when a message is a reply and will indicate if it is a self reply.mid
and text
, the reply_to
object will also be returned in the message object in Message
and Echo
webhooks. The reply_to
object will be populated with the mid
that the message is replying to and will contain a boolean field is_self_reply
that indicates whether the message is a self reply or just a reply.receiving_app_control_expiration
. Invalid values or Conversation Control actions reset the window to 1 day.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
.receiving_app_control_expiration
. Invalid values or Conversation Control actions reset the window to 1 day.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
.response_feedback
webhookresponse_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
.graph.instagram.com
instagram_business_basic
instagram_business_content_publishing
instagram_business_manage_comments
instagram_business_manage_messages
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.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.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
.message_edits
Webhook Eventmessage_edits
webhook event notifies you when a user edits a previously-sent message. Learn more about this webhook event here
.reel
and the attachment payload will include the title, URL, and video ID of the reel.from
field and parent context via parent_id
introduced to the group_feed
webhook. You may need to update your webhooks server to handle these new fields.postback
and web_url
.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.notification_messages_frequency
property for recurring notification opt in requests
is deprecatedand 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.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.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.GET /PAGE-ID/notification_message_tokens
endpoint
.image_aspect_ratio
– Set an image to a horizontal or square aspect ratio for opt in requestselements
– Create a carousel of images for opt in requestsnotification_message_tokens
– Get a list of current notifications message tokensnotification_messages_cta_text
– Customize the text for call to actions for opt in requestshttps://ig.me/m/{ig_profile_handle}
on website, email, and more. Please refer to the developer documentation
for more details.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.IGID
field and fully rely on IGSID
field. See developer documentation
for details in order to migrate before December 14, 2021.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
).<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
.
Instagram Comment Webhooks