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.

Requirements

In order to use this API:

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 by using the Apps interface, which is located in the Group Settings panel of the group's Facebook page:

Accessing the Group Settings panel.

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.