Meta Developer Docs

Appearance

Fresh 2026

Version 2.12 ​

Graph API | Marketing API

Changelog entries are categorized in the following way:

  • New Features, New products or services, including new nodes, edges, and fields.
  • Changes, Changes to existing products or services (not including Deprecations).
  • Deprecations, Existing products or services that are being removed.
  • 90-Day Breaking Changes, Changes and deprecations that will take effect 90 days after the version release date.

New Features, Changes, and Deprecations only affect this version. 90-Day Breaking Changes affect all versions.

Breaking Changes are not included here since they are not tied to specific releases.

Graph API ​

Released January 30, 2018 | Available until May 5, 2020 | Blog Post

  • New Features
  • Changes
  • Deprecations
  • 90-Day Breaking Changes

New Features ​

No new features.

Changes ​

  • Webhooks

Webhooks ​

  • Page Topic, sender_name and sender_id have been replaced with a single from property in Mentions for Workplace subscriptions.

Deprecations ​

No deprecations.

90-Day Breaking Changes ​

  • Events
  • Groups
  • Pages
  • Videos

Events ​

  • GET /event, GET operations on the following fields now require an access token of an Admin of the Event.

    • is_draft
    • can_guests_invite
    • guest_list_enabled
    • attending
    • interested
    • declined
    • maybe
    • noreply
    • roles
    • ticket_tiers
    • feed
    • posts
    • comments
    • photos
    • live_videos

In addition, the following fields have been deprecated:

  • is_viewer_admin

  • can_viewer_post

  • POST /event, POST operations now require an access token of an Admin of the Event.

  • Event-Owned Objects, GET operations on Event-owned objects now require an access token of an Admin of the Event. This affects the following nodes:

    • GET /post
    • GET /comment
    • GET /photo
    • GET /live_video

Groups ​

  • GET /group, GET operations on the following fields and edges now require an access token of an Admin of the Group:

Fields

  • member_request_count
  • owner
  • privacy
  • updated_time

Edges

  • GET /albums*
  • GET /admins
  • GET /docs*
  • GET /events*
  • GET /feed*
  • GET /files
  • GET /former_members
  • GET /groups*
  • GET /links*
  • GET /live_videos*
  • GET /member_requests
  • GET /members
  • GET /moderators
  • GET /posts*
  • GET /tagged
  • GET /videos*

In the coming weeks, edges marked with an asterisk (*) will once again allow requests from non-Admin Group members. However, responses will not include User information unless the request is made with an access token of an Admin of the Group.

  • POST /group, POST operations now require an access token of an Admin of the Group.

  • Group-Owned Objects, GET operations on Group-owned objects now require an access token of an Admin of the Group. This affects the following nodes:

    • GET /album
    • GET /comment
    • GET /doc
    • GET /event
    • GET /live_video
    • GET /photo
    • GET /post

Pages ​

  • Impressions Reporting, Redefining the use of organic from not paid, not viral to not paid and introducing a new sets of metrics called nonviral which will match the old definition of organic from and earlier versions. The new relationship:

    • total impressions = paid impressions + organic impressions
    • organic impressions = viral impressions + nonviral impressions

This affects the following endpoints:

  • GET /page/insights

  • GET /post/insights

  • Insights, Changing the results returned by like and unlike metrics.

The following like metrics:

  • /page/insights/page_fans_by_like_source_unique
  • /page/insights/page_fans_by_like_source

now return:

  • Ads
  • Other
  • Page Suggestions
  • News Feed
  • Your Page
  • Restored Likes from Reactivated Accounts
  • Search

The following unlike metrics:

  • /page/insights/page_fans_by_unlike_source_unique
  • /page/insights/page_fans_by_unlike_source

now return:

  • Deactivated or Memorialized Account Removals
  • Suspicious Account Removals
  • Unlikes from Page, Posts, or News Feed
  • Unlikes from Search
  • Underage Account Removals
  • Unlikes from Page Suggestions
  • Other

Videos ​

  • Page-owned videos, The source field will no longer be returned for Page-owned videos unless the User making the request has a role on the owning Page. This affects the following endpoints:

    • GET /video
    • GET /post
    • GET /page/videos
    • GET /page/posts
    • GET /page/feed

Marketing API ​

Released January 30, 2018 | Available Until Aug 7, 2018 | Blog Post

Please refer to the blog post for a summary of changes.