Appearance
Fresh 2026
Version 5.0
Released October 29, 2019 | Available until February 3, 2022
- Application
- Marketing API
- Messenger
- Pages
Application
This change applies to v5.0+.
The following endpoints are deprecated:
GET /{application-id}/objectsPOST /{application-id}/objects
Marketing API
Released October 29, 2019 | Available until September 28, 2020
Messenger
New Features
These changes apply to all versions.
- Click to Messenger Ads support for Handover protocol. Ads can now indicate the app id that will have control over the thread once a user clicks on the ad.
- Replies and Reactions Webhooks. It is now possible to receive webhook events when users react or reply to messages from businesses.
POST / GET / DELETE /{page-id}/messenger_profile, Ice Breakers. Apps can now set icebreakers on the Messenger profile via the API to provide a set of common questions that users can use to start a conversation.GET /{thread-id}, Admin Messages Filter. Apps can now filter out admin messages to just get messages between the Page and the user.
Deprecations
These changes apply to various versions.
The following endpoints are deprecated for versions v5.0+. They supported plain text only private replies. Use the New Private Replies instead.
POST /{comment-id}/private_repliesPOST /{post-id}/private_replies
The following endpoints wil be deprecated for all versions on March 4, 2020.
POST /{ad-account-id}/sponsored_message_adsPOST /{broadcast-id}POST /{page-id}/broadcast_messagesPOST /{page-id}/broadcast_reach_estimationsPOST /{page-id}/message_creatives
Pages
Error Messages
This change applies to all versions.
Endpoints that require manage_pages or Page Public Content Access and return an error code 10 when both permissions are missing will now return a new error message:
This endpoint requires the 'manage_pages' permission or the 'Page Public Content Access' feature. Refer to manage_pages and Page Public Content Access for details.
Page Public Content Access
This change applies to v5.0+
Requests made to endpoints that require the Page Public Content Access feature must be made with either an App Access Token or include the app's App Secret. If the calling app has been granted the manage_pages permission however, an app access token or app secret is not required.