daily_budget or lifetime_budget. When neither field is provided, Meta may set an estimated daily budget cap for the campaign.daily_budget or lifetime_budget. If the budget you provide is lower than the generated budget reference for the campaign, the API may return a non-blocking warning. Your campaign will still use the budget you provided.web_url) or sends a postback to your webhook (postback), and you can add an optional title, subtitle, and up to three buttons below the grid.10 – 1893063 to the Messenger Platform common error codes reference for Pages temporarily restricted from sending messages.start_time and end_time Unix timestamp fields when creating a marketing messages campaign.start_time, end_time, both, or neither. Lifetime-budget campaigns default to a 30-day end window from start_time, or from campaign creation time when start_time is also omitted.min_conversation_gap_seconds to prevent sending when recent organic Messenger thread activity between the Page and the end user is inside the requested gap.2300052 with the message This person is not available right now.GET /sticker_packs — List available sticker packs with name, description, preview image, and sticker count.GET /sticker_packs/<STICKER_PACK_ID>/stickers — List stickers within a specific pack, including id, name, image URL, and dimensions.GET /sticker_search?q=<QUERY> — Search stickers by keyword across all available packs. Supports multilingual search with the locale parameter using a supported locale code (for example, locale=vi_VN for Vietnamese or locale=ko_KR for Korean). Defaults to en_US.sticker_id field:{ "recipient": {"id": "<PSID>"}, "message": {"sticker_id": 767226160478561} }
type: "sticker" attachment with sticker_id metadata, alongside the existing type: "image" attachment. During the 90-day transition period (until August 30, 2026), both attachment types are present in the payload. After the transition, only the sticker attachment type will be sent.sticker attachment type before August 30, 2026. The same change applies to message echoes and Conversations API responses.pages_messaging.pixel_id parameter when creating a marketing messages campaign. Partners can provide a Meta Pixel ID to enable offsite conversion attribution for the campaign.pixel_id is not provided and the ad account has exactly one active accessible pixel, Meta may use that pixel for attribution. If the ad account has no active pixels or more than one active pixel, the campaign is still created without pixel tracking.pixel_id explicitly when you want offsite conversion attribution.adset{promoted_object{pixel_id}}.fields=actions,action_values,website_purchase_roas, action_breakdowns=action_type, and a filtering parameter that includes the supported offsite_conversion.fb_pixel_* action types.offsite_conversion.fb_pixel_purchase, offsite_conversion.fb_pixel_add_to_cart, offsite_conversion.fb_pixel_initiate_checkout, offsite_conversion.fb_pixel_lead, offsite_conversion.fb_pixel_view_content, offsite_conversion.fb_pixel_custom, offsite_conversion.fb_pixel_complete_registration, offsite_conversion.fb_pixel_search, offsite_conversion.fb_pixel_add_payment_info, and offsite_conversion.fb_pixel_add_to_wishlist.RECIPIENT_UNAVAILABLE error./message_campaigns endpoint.https:// scheme.paid_marketing_messages permission as Flow 1 (Business Portfolio Flow). After the client completes login, the partner connects their own ad account to the client’s Business Integration System User (BISU) by calling the new POST https://api.facebook.com/system_accounts/<BISU_ID>/asset-connections endpoint.business_management permission in addition to the standard MAPI-D permissions; complete App Review for business_management before serving clients with this flow.marketing_message_delivery_failed Webhook Coverage Improvementmarketing_message_delivery_failed webhook coverage to cover the majority of errors during the async message sending phase.default_action URL Fix for Generic Templatedefault_action URL per the API specification, instead of the first button URL.default_action incorrectly required a title field.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.marketing_message_delivery_failed webhook coverage to report all message drops during the async message sending stage.post, ig_post, reel, ig_reel) with url, title and idpost, ig_post, reel, ig_reel)time_range and date_preset parameters now work for all metrics on the insights endpoint.{{first_name}}) are now enabled on the coupon-code pre-message greeting for coupon-template marketing messages.appointment_booking attachment with status, start/end times, and timezone when fetching
conversation messages.appointment_booking.recipient_id=0 when the page-scoped ID was null, causing webhook delivery to silently fail for partners.{{first_name}}, {{last_name}}, and {{full_name}} macros.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.messenger_marketing_messages_page field in the Custom Audiences API for Marketing Messages custom audiences.do_not_return_duplicates parameter in the Subscription Tokens API.image_urls parameter in your message payload and specify the images you would like to display.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.{{first_name}}, {{last_name}}, and {{full_name}} can be added into the title and subtitle strings to enable personalized marketing messages. For carousel, each element can have a personalized title and subtitle. Buttons do not have personalization enabled.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.subscription_token message sending cooldown has been updated from 24 hours to 12 hours. This means marketing messages sent using the same subscription_token now require only a 12-hour wait between sends, allowing for more frequent communication with users./<CUSTOM_AUDIENCE_ID>/users in the Custom Audience API, the corresponding Custom Audience ID(s) will be included in the subscription token’s custom_audience_ids field. Note that a single subscription token can be associated with multiple custom audience uploads.custom_audience_ids query parameter on the /<PAGE_ID>/notification_message_tokens endpoint./<PAGE_ID>/notification_message_tokens endpoint will only return subscription tokens for a given Custom Audience if there are 100 or more matched users in that audience upload. If fewer than 100 users match, tokens for that Custom Audience will be excluded from the response.act_<AD_ACCOUNT_ID>/insights endpointreceiving_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.cominstagram_business_basicinstagram_business_content_publishinginstagram_business_manage_commentsinstagram_business_manage_messagesig_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 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.GET /PAGE-ID/notification_message_tokens endpoint is now available for Instagram Messaging.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 requeststitle field has been added to the Recurring Notfication webhooks notification.https://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.