Graph API

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.

Messenger Platform

Multi App Routing

Multi App Routing is now available for Instagram Direct and Messenger.

Reels API

  • Hashtags are now supported in the POST /page-id/video_reels description field.
  • You can now crosspost Reels to Facebook Pages.

June 6, 2023

Instagram Ads API

Instagram Shop tab placement

The Instagram Shop tab ad placement (“instagram_positions”: [“shop”]) is no longer available for new ad campaigns.

This change affects the following endpoints when creating ads:

April 10, 2023

Pages API Metrics

  • page_impressions_organic renamed to page_impressions_organic_v2
  • page_impressions_organic_unique renamed to page_impressions_organic_unique_v2