Community

Path /community

Represents your Workplace community. The /community node returns a single community object of type Group. For API convenience, you can think of the Community object as a root Group for the other groups in a Workplace community.

You can find your Community ID by making a Graph API GET call to graph.facebook.com/community with a custom integration access token.

Reading

GET graph.facebook.com
  /community

Permissions

The community node requires either Read group content or Manage Groups permission.

Publishing

You can't publish a Workplace community using this node.

Deleting

You can't delete a Workplace community using this node.

Updating

You can't update a Workplace community using this node.

Edges

NameDescription

/admins

The System Administrators of a Workplace community.

/former_members

The former members of a Workplace community, whose accounts are now deactivated.

/groups

The groups in a Workplace community.

/members

The members of a Workplace community.

Examples

Creating a New Group

You can create a new group for a Workplace community by making a POST request to the /community/groups edge. The response will contain the ID of the newly-created group. Note that in order for your group to show any members, you must add at least one member and make the member an admin. Use the field group_type to set the group type (the purpose field is read-only).

POST graph.facebook.com
  /community/groups?
    name={...}&
    description={...}&
    privacy=OPEN

Get a list of all groups for a community:

GET graph.facebook.com
  /community/groups

Get a list of all members for a community:

GET graph.facebook.com
  /community/members

Add a new group to a community:

POST graph.facebook.com
  /community/groups?
    name={...}&
    description={...}&
    privacy=OPEN