2023 Out-Of-Cycle Changes

2023 out-of-cycle changes to Graph API and Marketing API.

December 14, 2023

Page Insights Metrics Deprecation

Applies to all versions on March 14, 2024.

On March 14, 2024, a number of the Page Insights metrics will be deprecated for all API versions. The API will return an invalid metric error when calling any of these metrics. Learn more.

~~page_actions_post_reactions_anger_total~~
~~page_actions_post_reactions_haha_total~~
~~page_actions_post_reactions_like_total~~
~~page_actions_post_reactions_love_total~~
~~page_actions_post_reactions_sorry_total~~
~~page_actions_post_reactions_total~~
~~page_actions_post_reactions_wow_total~~
page_call_phone_clicks_by_age_gender_logged_in_unique
page_call_phone_clicks_by_site_logged_in_unique
page_call_phone_clicks_logged_in_by_city_unique
page_call_phone_clicks_logged_in_by_country_unique
page_call_phone_clicks_logged_in_by_locale_unique
page_consumptions
page_content_activity
page_content_activity_by_action_type
page_content_activity_by_action_type_unique
page_content_activity_by_age_gender_unique
page_content_activity_by_city_unique
page_content_activity_by_country_unique
page_content_activity_by_locale_unique
page_content_activity_unique
page_cta_clicks_by_age_gender_logged_in_unique
page_cta_clicks_by_site_logged_in_unique
page_cta_clicks_logged_in_by_city_unique
page_cta_clicks_logged_in_by_country_unique
page_cta_clicks_logged_in_by_locale_unique
page_daily_follows_by_source_unique
page_daily_unfollows_by_source_unique
page_engaged_users
page_fans_by_like_source_unique
page_fans_by_like_source
page_fans_by_unlike_source_unique
page_fans_by_unlike_source
page_fans_gender_age
page_follows_city
page_follows_country
page_follows_gender_age
page_follows_locale
page_get_directions_clicks_by_age_gender_logged_in_unique
page_get_directions_clicks_by_site_logged_in_unique
page_get_directions_clicks_logged_in_by_city_unique
page_get_directions_clicks_logged_in_by_country_unique
page_impressions_frequency_distribution
page_places_checkin_mobile_unique
page_places_checkin_mobile
page_places_checkins_by_age_gender
page_places_checkins_by_city
page_places_checkins_by_country
page_places_checkins_by_locale
page_positive_feedback_by_type_unique
page_positive_feedback_by_type
page_positive_feedback_unique
page_positive_feedback
page_posts_impressions_frequency_distribution
page_views_by_age_gender_logged_in_unique
page_views_by_city_logged_in_unique
page_views_by_country_logged_in_unique
page_views_by_internal_referer_logged_in_unique
page_views_by_locale_logged_in_unique
page_views_by_profile_tab_logged_in_unique
page_views_by_profile_tab_total
page_views_by_referers_logged_in_unique
page_views_by_site_logged_in_unique
page_views_external_referrals
page_views_logged_in_total
page_views_logged_in_unique
page_views_login_unique
page_views_login
page_views_logout
page_website_clicks_by_age_gender_logged_in_unique
page_website_clicks_by_site_logged_in_unique
page_website_clicks_logged_in_by_city_unique
page_website_clicks_logged_in_by_country_unique
page_website_clicks_logged_in_by_locale_unique
post_activity
~~post_activity_by_action_type~~
~~post_activity_by_action_type_unique~~
post_activity_unique
post_impressions_fan_paid_unique*
post_impressions_fan_paid*

September 15, 2023

User Accounts

This change reduces the scope of the User Accounts change introduced with version 17. That change now only applies to v17.0 and later.

Applies to v17.0 and later versions. Will apply to all versions when version 19 is released (date to be determined).

The GET /{user-id}/accounts (aka GET /me/accounts) endpoint no longer returns Facebook pages that have been linked to a Meta business account, unless the app user has granted the business_management permission to the app and has a role on the linked business account.

June 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.