Version 2.5

Graph API | Marketing API

Graph API v2.5

Released October 7, 2015 | Available until April 12, 2018

This version expired April 12, 2018. Please use the API Upgrade Tool to upgrade your apps before this date. Learn more about upgrading your apps in the Upgrade Guide.

New Features


  • Permissions

    • GET {user_id}/accounts now requires either manage_pages or pages_show_list; the latter is a new permission in v2.5.
    • POST {page_id}/call_to_actions and POST/DELETE {call-to-action-id} require the new permission pages_manage_cta that we introduce in v2.5.
  • Managing Call-to-Actions - Pages can now manage call to actions on a Page:

    • GET page/call_to_actions or GET {call-to-action-id} to read a call to action.
    • POST page/call_to_actions to add a call to action to a page.
    • POST {call-to-action-id} to update.
    • DELETE {call-to-action-id} to delete a Page's call to action.
  • Place Node - The following field has been added to the Place node:

    • overall_rating - This provides the average rating based on public reviews of a place.


  • Video Upload - The following parameters have been added:

    • slideshow_spec - Generate slide show videos by uploading images.
    • secret - Published video will not appear on Facebook Newsfeed, Timeline, or Page video tabs and is not searchable. A video can be viewed and shared using a permalink only. For page users only.
    • social_actions - Enable or prohibit the use of Facebook social actions such as likes, comments, and sharing on an hidden video. For page users only.
  • Video Editing - The following parameters have been added:

    • publish_to_videos_tab - Distribute video items publicly to the Page's Videos tab, but not News Feed or Timeline.
    • publish_to_news_feed - Distribute video items publicly to News Feed, Page Timeline, and a Page's Videos tab.



  • Tagged Posts Endpoint - GET /{page-id}/tagged will include all public posts in which the page has been tagged. A page access token with manage_pages permission is required.


  • story_tags - Now returns an array, not an object.


  • GET /{user-id}?fields=address returns an error - The address field, which was available in previous versions and returned an empty value, will return an error as of v2.5.

Webhooks (Formerly Real Time Updates)

  • Automatically Disable Subscriptions - We now automatically disable Webhooks subscriptions if the callback URL fails for 7 days straight. You can re-enable it with a POST request to /subscriptions. This change does not apply to payments subscriptions.

  • Updating Existing Subscriptions - Existing Webhooks subscriptions may be modified via the /subscriptions API. POST /subscriptions will amend the subscription for the given topic without overwriting existing fields. You can delete specific fields from your subscription by including a fields param when calling DELETE /subscriptions.


  • No deprecations.

90 Day Breaking Changes


  • Page Tab Apps URI Format - Page Tab Apps URI format{vanity}?v={app_id} will no longer work 90 days after this release. Please use{vanity}?sk={app_id} or{vanity}/{app_id}.


  • New Real Time Updates via HTTPS Only - New subscriptions cannot be created with a non-HTTPS callback URL. This affects User, Page, App, and Payment updates.