Groups API

Groups API

The Groups API is a collection of Graph API endpoints that let you read and create Facebook Group data on behalf of group members.

By installing your app on a group, a group admin can grant your app access to group content, such as posts, photos, and videos, and allow you to publish content to the group on behalf of the admin. Admins can also allow you to access publicly available information about group members who have chosen to share their public information with apps installed on the group.

Beginning February 23, 2021, the Groups API is introducing 2 breaking changes that will affect all versions for the API after 90 days.

  • To align with other Facebook data retention policies, the Groups API will only include data from posts created within the last 90 days.
  • Groups API will now use a 2 tiered API access level system, Standard level and Advanced level, instead of Dev mode and Live mode access. Standard level access will only allow you to get data for users that have a role on your app, while Advanced level access will allow you to get data from all users in the group that the app is installed in.

Common Uses

Requirements

In order to use this API:

  • Your app must go through the App Review process. The rest of this section gives details.
  • A group member must install your app on the group.

App Review

This API requires App Review. To gain access, include the following features and permissions with your submission.

Features

  • Groups API

Permissions

  • publish_to_groups (required if your app will publish data to the group on the member's behalf)
  • groups_access_member_info (required if you want access to group member public info. — see limitations below)

App Installation

Group admins can locate and install your app as described in the Help Center, How do I add an app.

Limitations

By default, personally identifiable information will not be included in API responses. For example, when requesting the content's of a post, the response will not include the name of the member who created the post.

In order to have a group member's default User fields included in API responses when available, the member must grant your app the groups_access_member_info permission. This permission can be granted through Facebook Login or through the Groups UI. For information about how to use the UI to grant permission, see Allow or remove access to group apps in the Help Center.

Endpoints

View our reference for a list of available endpoints.