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 root community object as a root Group for the other groups or communities.

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

In some cases, a root community can also contain other communities, which will be appear on the /groups edge of the root community. Child communities of a root community can be distinguished from child groups by the is_community field.

The existance of one or more communities inside a root community identifies that this Workplace instance is community-enabled.

These child communities can be queried in turn on their /groups edge to get the groups within that community. In all cases the /groups edge will only show direct descendants of that community; recursion will not be performed.

Communities cannot be created via the API, but members can be managed in the same way as group members are.

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. Manage Accounts permission is required for this edge

/former_members

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

/groups

The groups and sub-communities in a Workplace community.

/members

The members of a Workplace community. Filterable on users' external IDs using the external_ids parameter

/accounts

Use this edge to create/deactivate/delete accounts in a Workplace Community. Provision User Accounts permission is required for this edge

/events

The events of a Workplace community.

/reported_content

The list of reported content items for community admins to review.

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.

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

Get a list of all groups and communities for a root community:

GET graph.facebook.com
  /community/groups?fields=is_community

Get a list of all members for a root community:

GET graph.facebook.com
  /community/members

Get a list of all members for a root community, filtering on external_id:

GET /company/members?
  external_ids=12356,abc123

Report an item of content:

POST graph.facebook.com
  /community/reported_content?
    content_id={...}

Add a new group to a root community:

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

Add a new group to a non-root community:

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

Provision an account:

POST graph.facebook.com
  /community/accounts?
    name={...}&
    email={...}&
    department={...}&
    division={...}&
    organization={...}&
    title={...}&
    manager={...}&
    hire_date={...}&
    invite={...}&
    active={...}

Updates to an account require the Manage Work Profiles permission and should use the following endpoint

POST /{member-id}

Further information available on the Account Management page.