/{group-id}
Represents a Workplace group. The /{group-id}
node returns a single group.
You can read information about a group by making a Graph API GET
request to /{group-id}
.
Reading Group node requires either Read content or Read company visible content permission for closed/secret groups and open groups respectively.
Field Name | Description | Data Type |
---|---|---|
| The group ID. |
|
| Information about the Group's cover photo. | |
| A brief description of the group. |
|
| The URL for the group's icon. |
|
| Indicates whether the group is a default Workplace group (read only). |
|
| The name of the group. |
|
| The member that created this group. | |
| The privacy setting of the group. Possible values:
|
|
| The last time the group was updated (this includes changes in the group's properties and changes in posts and comments if the session user can see them). |
|
| Indicates whether the group was archived (read only). |
|
| Indicates whether the group is a community and can therefore contain other groups (read only). |
|
You can't publish using this edge. In order to create a group, publish to the /community/groups
edge.
You can't delete a group using this node. Removing the last member of a group will delete that group automatically.
You can update a group by making a Graph API POST
request to /{group-id}
and passing values for the fields to be updated.
Making updates to a group node requires the Manage groups and Manage content permissions.
Field Name | Description | Type |
---|---|---|
| The name of the group being updated. |
|
| A URL containing an image for the group cover photo. |
|
| The privacy setting of the group. Possible values:
|
|
Edge Name | Description |
---|---|
The admins of a Workplace group. | |
The photo albums in a Workplace group. | |
The docs in a Workplace group. | |
The events in a Workplace group. | |
The posts in a Workplace group, arranged into a feed. | |
The files shared into a Workplace group. | |
| The groups contained within this community (if this group is a community) |
| The pending membership requests for groups that have membership approvals enabled. |
The members of a Workplace group. This edge exposes:
| |
| The moderators of a Workplace group. |
GET graph.facebook.com
/{group-id}?fields=id,name,privacy
GET graph.facebook.com
/{group-id}/members?fields=name,id,joined
GET graph.facebook.com
/{group-id}?fields=admins,moderators
GET graph.facebook.com
/{group-id}/docs
GET graph.facebook.com
/{group-id}/feed
GET graph.facebook.com
/{group-id}/feed?fields=attachments
Poll options are listed in descending order according to vote count for each option.
GET graph.facebook.com
/{group-id}/members?fields=name,joined
POST graph.facebook.com
/{group-id}/members/{member-id}
POST graph.facebook.com
/{group-id}/members?email=michael%40example.com
When including email addresses in the URL for a request, ensure that the email addresses is URL encoded. Example: michael@example.com
becomes michael%40example.com
.
Removing the last member from a group will schedule that group for deletion.
DELETE graph.facebook.com
/{group-id}/members/{member-id}
DELETE graph.facebook.com
/{group-id}/members?email=michael%40example.com
When including email addresses in the URL for a request, ensure that the email addresses is URL encoded. Example: michael@example.com
becomes michael%40example.com
.
POST graph.facebook.com
/{group-id}/admins/{user-id}
DELETE graph.facebook.com
/{group-id}/admins/{user-id}
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
POST graph.facebook.com
/{group-id}/photos?source={image-data}
POST graph.facebook.com
/{group-id}/photos?url={image-data}
POST graph.facebook.com
/{group-id}/docs?title=title%20of%20doc&body=body%20of%20the%20doc
POST graph.facebook.com
/{group-id}/groups