Group

Path /{group-id}

Represents a Workplace group. The /{group-id} node returns a single group.

Multi-company groups

There are specific considerations which should be taken into account when accessing multi-company groups:

• Group content can be read by any app of integration installed in a company that is part of a multi-company group
• Multi-company groups are listed in communities or groups alongside regular groups
  • The purpose field can be used to identify multi-company groups. This value be set to WORK_MULTI_COMPANY
• Group members can also be queried, but only id, name and picture will be visible if an app is from a different company to the user
• Integrations with the Manage group permission can add and remove multi-company group members
  • Integrations can only add and remove users who are members of the community which the integration is installed on
  • Integrations can only add and remove users when one of the group admins is a member of the community which the integration is installed on
• An integration with the Manage group content permission can delete content contained within a multi-company group if either:
  • The content belongs to a member of the app community or
  • A member of the app community is a group admin
• Publishing to multi-company groups is currently not available
• Multi-company groups can be selected in the group scoping setting for integrations
• Bots cannot be mentioned in multi-company groups

Reading

You can read information about a group by making a Graph API GET request to /{group-id}.

Permissions

Reading Group node requires the Read group content permission.

Fields

Publishing

You can't publish using this edge. In order to create a group, publish to the /community/groups edge.

Deleting

You can't delete a group using this node. Removing the last member of a group will delete that group automatically.

Updating

You can update a group by making a Graph API POST request to /{group-id} and passing values for the fields to be updated in the request body.

Permissions

Making updates to a group node requires the Manage groups permission.

Edges

Examples

Get group id, name, archive status, and privacy:

GET graph.facebook.com
  /{group-id}?fields=id,name,archived,privacy

Archive a group:

POST graph.facebook.com
  /{group-id}?archive=true

Get group members with name, id, and join date:

GET graph.facebook.com
  /{group-id}/members?fields=name,id,joined

Get a group's admins and moderators in a single call:

GET graph.facebook.com
  /{group-id}?fields=admins,moderators

Get group docs:

GET graph.facebook.com
  /{group-id}/docs

Get group posts:

GET graph.facebook.com
  /{group-id}/feed

Get group posts in last updated order:

GET graph.facebook.com
  /{group-id}/feed?sorting_setting=RECENT_ACTIVITY

Parameters

sorting_setting

Allows ordering of posts by the time they were last updated instead of created when set to RECENT_ACTIVITY. The default behaviour can be set explicitly by using CHRONOLOGICAL as value. Updates may include edits to the post as well as a comment or reaction having been added.

Get group posts including additional attachments like videos, images, files, or polls:

GET graph.facebook.com
  /{group-id}/feed?fields=attachments

Get a list of group members, along with their join date:

GET graph.facebook.com
  /{group-id}/members?fields=name,joined

Add a member to a group by id:

POST graph.facebook.com
  /{group-id}/members/{member-id}

Add a member to a group by email:

POST graph.facebook.com
  /{group-id}/members?email=michael%40example.com

Remove a member from a group by id:

DELETE graph.facebook.com
  /{group-id}/members/{member-id}

Remove a member from a group by email:

DELETE graph.facebook.com
  /{group-id}/members?email=michael%40example.com

Promote a member to admin of a group:

POST graph.facebook.com
  /{group-id}/admins/{user-id}

Demote an admin to member of a group:

DELETE graph.facebook.com
  /{group-id}/admins/{user-id}

Create a new Event in a group:

POST graph.facebook.com
  /{group-id}/events
  ?name=New+Event
  &start_time=2017-03-02T14:00:04+00:00
  &end_time=2017-03-02T15:00:04+00:00
  &description=Test+Description
  &location=Boardroom

Upload a new photo (via binary) to a group:

POST graph.facebook.com
  /{group-id}/photos?source={image-data}

Upload a new photo (via url) to a group:

POST graph.facebook.com
  /{group-id}/photos?url={image-data}

Create group posts with image & video attachments:

POST graph.facebook.com
  /{group-id}/feed?attached_media=[{"media_fbid":"{photo-id}"},{"media_fbid":"{photo-id}"}]

Parameters

attached_media

Used for photos & videos, an array of media_fbids wrapped in braces. Supports the following image formats: .jpeg, .bmp, .png, .gif, .tiff. More information about image formats can be found here. Supported video files can be found here. To obtain media_fbids for images, please publish unpublished photos to https://graph.facebook.com/me/photos first, as described in the documentation here. To obtain media_fbids for videos (including animated GIFs), please publish videos first to https://graph.facebook.com/me/videos?no_story=true.

Create group posts with file attachments:

POST graph.facebook.com
  /{group-id}/feed?files=[{file-id},{file-id}]

Parameters

files

Used for files, an array of file_ids (note they are not wrapped in braces). File versioning is not currently supported. To update files, please remove the original file from the post attachments and re-upload a new file attachment. Supports the following file formats:

• Documents: .pdf, .csv, .tsv, .docx, .pptx, .xlsx
• Images: .jpeg, .png
• Videos: .mp4
• Archives: .rar, .zip

To obtain file_ids, please publish files to https://graph.facebook.com/group_file_revisions first. You may publish source files locally from your computer.

Update the post permissions, join settings, purpose and post approval settings

POST graph.facebook.com
  /{group-id}/?post_permissions=NONE&join_setting=ADMIN_ONLY&purpose=WORK_SOCIAL&post_requires_admin_approval=false

Get the reactions and comments to the pinned post

GET graph.facebook.com
  /{group-id}/pinned_posts?fields=reactions,comments

Identify whether a group is also a community

GET graph.facebook.com
  /{group-id}?fields=is_community

Get the membership rules to a group

GET graph.facebook.com
  /{group-id}/auto_membership_rules

Example Response (JSON):

{
  "data": [
    {
      "conditions": [
        {
          "field": "TITLE",
          "operator": "CONTAINS",
          "values": [
            "sales"
          ]
        }
      ],
      "id": RULE_ID
    }
  ],
  ...
}

Delete an auto membership rule for a group

DELETE graph.facebook.com
  /RULE_ID

Apply a membership rule to a group

POST graph.facebook.com
  /{group-id}/auto_membership_rules

Example Payload:

{
    "conditions": [
        {
            "field": "LOCATION",
            "operator": "CONTAINS",
            "values": ["London", "San Francisco"]
        }
    ]
  }

Get Group ID and Official Group Status:

GET graph.facebook.com
  /{group-id}?fields=id,is_official_group

Update Official Group Status:

POST graph.facebook.com
  /{group-id?is_official_group={FALSE | TRUE}