Meta Developer Docs

Appearance

Fresh 2026

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_reelsdescription 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:

  • POST /{ad-accout-id}/adsets
  • POST /ad_set_id
  • GET /{ad-id}/previews
  • GET /{ad-account-id}/generatepreviews

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