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}/objects
• POST /{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_replies
• POST /{post-id}/private_replies

The following endpoints wil be deprecated for all versions on March 4, 2020.

• POST /{ad-account-id}/sponsored_message_ads
• POST /{broadcast-id}
• POST /{page-id}/broadcast_messages
• POST /{page-id}/broadcast_reach_estimations
• POST /{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 https://developers.facebook.com/docs/facebook-login/permissions#reference-manage_pages and https://developers.facebook.com/docs/apps/review/feature#reference-PAGES_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.