Back to News for Developers

Business Manager API, Pages API, and Marketing API v2.11

November 7, 2017ByEmily Hahn

Today we're delighted to announce the latest version of the Business Manager API, Pages API, and Marketing API v2.11.

Business Manager API Updates

We're making it easier for businesses to manage their associated users and assets with these changes to the Business Manager API.

  • Users at Business Level: We're giving businesses more flexibility and control over their associated users. Now the same user can have different levels of permissions for each business it's associated with. Users can manage their profile, permissions, and assets associated with each business.
  • Inviting New Users: We're also updating user invitations. You can now invite users to join a business and control the status of their invitation.
  • Asset Categorization: Finally, we're giving you the ability to group assets into categories and access these categories through different endpoints. This update improves performance when handling large amounts of assets and makes it easier to paginate results.

Learn more about the Business Manager API.

Pages API Updates

Pages API enhancements for Private Replies, Posts, and Commenting

We've enhanced features for supporting private replies for visitor posts POST /{post-id}/private_replies, getting a list of scheduled posts GET/{page-id}/scheduled_posts on a page, and the ability for a Page to @mention a user in a comment.

  • Get scheduled posts: You can now get a list of scheduled posts for a page. This allows you to more effectively manage and plan for posts that are going to occur in the future.
  • Privately reply to visitor posts: You can now privately reply to a visitor post and encourage your clients to engage with their audience.
  • @Mention a user: You can now @mention the user in a comment or a reply within that post.

Requiring Page Access Tokens

Apps without a valid authentication token for a Page will no longer have access to the User node through the API. The apps without valid authentication may still pull comment threads and other engagement actions from third-party Pages, but userIDs and names will not be available through the API.

Additionally, the following actions will require a Page access token: get: Page/Insights and get:PageName/tagged.

The requirements for Page access tokens will take affect on February 6, 2018 and will impact all versions of the Graph API. After this date, if this method is called without a Page access token, it will return an error.

Learn more about the Pages API.

Link Ads

We recently announced an initiative to make the Facebook Advertising platform more transparent to Facebook users. Read more about this initiative in our press release.

To enable the Facebook Advertising transparency initiative, the Facebook Marketing API is deprecating Event Ads and Link Ads that are not connected to a valid page. This breaking change will impact all the currently supported API versions; for example, Marketing API version v2.11, v2.10, and v2.9. The change will go into effect on November 14, 2017.

The existing Event and Link Ads that were created earlier will continue to run but you cannot modify these ad's creatives or create new ads once the change goes in effect.

Learn more about the Link Ads change and how it relates to Ad Groups, Ad Creative, and Preview.

Ads experience

  • Real-Time Location in Carousel Ads: You can now add a map card to a Carousel ad that shows store locations that are near the user for ads where the objective is Traffic or Conversion. These new options are now available: type=REALTIME and location_source_id = PAGE_ID in place_data inside AD_CREATIVE_ID/object_story_spec. Learn more
  • Consistent Destination per Ad set: The destination a user is taken to upon clicking an ad or a call to action is now consistent for all ads within an ad set using the new field destination_type. Learn more


  • Geo-targeting: You can now use classic geo-targeting for store visit objectives. This feature enables you to target geographic areas beyond a radius around a store location. Learn more


  • KPI tracking: There's now a new field kpi_type to ad_ACCOUNT_ID/CAMPAIGN_ID. This field describes the type of key performance indicator you want to track for the campaign or ad objects in the campaign. Learn more

Related documentation

For full documentation, refer to the Graph API v2.11 changelog. SDK developers should view our latest Java SDK, PHP SDK, Python SDK, Ruby Ads SDK, or Nodejs Ads SDK. Web developers should specify /v2.11/ in URLs when you call the API.