Community

Path /community

Alternative path /company

Represents your Workplace community. The /community node (or /company, which works interchangeably) 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

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 /community/members?
  external_ids=12356,abc123

Report an item of content (Please note this edge was deprecated on April 30, 2019):

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={...}

List available badges:

GET graph.facebook.com
  /community/badges?fields=id,name,description,icon,category

List the root level categories:

GET graph.facebook.com
  /community/knowledge_library_categories

Publish a new root level category:

POST graph.facebook.com
  /community/knowledge_library_categories?
  title={...}&
  icon={...}&
  color={...}&
  json_content={...}

List the links for frequently used tools and other resources within Knowledge Library:

GET graph.facebook.com
        /community/knowledge_quick_links?fields=title,link

Read a specific quick link in Knowledge Library

GET graph.facebook.com
        /{quick_link_id}?fields=title,link

Add a new quick link in Knowledge Library

POST graph.facebook.com
        /community/knowledge_quick_links?
        title={...}&
        link={...}

Update a specific quick link in Knowledge Library

POST graph.facebook.com
        /{quick_link_id}?
        title={...}&
        link={...}

Delete a specific quick link in Knowledge Library

DELETE graph.facebook.com
        /{quick_link_id}