Facebook Developers
DocumentationSupportBlogAppsLog In
  • Getting Started
  • Core Concepts
    • Social Design
    • Social Plugins
    • Open Graph
    • Social Channels
    • Authentication
    • Graph API
  • Advanced Topics
  • SDK Reference
  • Tools
  • Concepts
    • Batch Requests
    • Permissions
    • Real-time Updates
  • Objects
    • Achievement(Instance)
    • Album
    • Application
    • Checkin
    • Comment
    • Domain
    • Event
    • FriendList
    • Group
    • Insights
    • Link
    • Message
    • Note
    • Offer
    • Order
    • Page
    • Photo
    • Post
    • Question
    • QuestionOption
    • Review
    • Status message
    • Thread
    • User
    • Video

Group

Core Concepts › Graph API › Group

A Facebook Group. The User and Page objects have a groups connection.

To read a Group, you need:

  • any valid access_token if the group is public (i.e. the group's privacy setting is OPEN)
  • user_groups permission for a user's non-public groups
  • friends_groups permission for a user's friend's non-public groups

Example

The Facebook Developers Group:

https://graph.facebook.com/195466193802264


Fields

NameDescriptionPermissionsReturns
id

The group ID

generic access_token, user_groups, or friends_groups

string

version

A flag which indicates if the group was created prior to launch of the current groups product in October 2010

generic access_token, user_groups, or friends_groups

int where 0 = Old type Group, 1 = Current Group

icon

The URL for the group's icon

generic access_token, user_groups, or friends_groups

string containing a valid URL

owner

The profile that created this group

generic access_token, user_groups, or friends_groups

object containing the id and name fields

name

The name of the group

generic access_token, user_groups, or friends_groups

string

description

A brief description of the group

generic access_token, user_groups, or friends_groups

string

link

The URL for the group's website

generic access_token, user_groups, or friends_groups

string containing a valid URL

privacy

The privacy setting of the group

generic access_token, user_groups, or friends_groups

string containing OPEN, CLOSED, or SECRET

updated_time

The last time the group was updated

generic access_token, user_groups, or friends_groups

string containing ISO-8601 date-time


Connections

NameDescriptionPermissionsReturns
feed

This group's wall.

any valid access_token, user_groups, or friends_groups

array of Post objects.

members

All of the users who are members of this group (can only currently return the first 500 members).

any valid access_token, user_groups, or friends_groups

array of objects containing id, and name, fields; some members will also have an administrator field.

picture

The profile picture of this group.

any valid access_token, user_groups, or friends_groups

HTTP 302 with the URL of the group's profile picture

docs

The docs in this group.

any valid access_token, user_groups, or friends_groups

array of objects containing id, from, subject, message, icon, updated_time, revision, can_edit, and can_delete fields.


feed

This connection corresponds to the Group's wall. You can create a link, post or status message by issuing an HTTP POST request to the GROUP_ID/feed connection.

links

Create

You can post a link on the Group's wall by issuing an HTTP POST request to GROUP_ID/feed with the publish_stream permissions and the following parameters.

Parameter Description Type Required
link Link URL string yes
message Link message string no

The other fields are taken from the metadata of the page URL given in the 'link' param.

If the create is successful, you get the following return.

Name Description Type
id The new link ID string

posts

Create

You can create a post on a Group's wall by issuing an HTTP POST request to GROUP_ID/feed with the publish_stream permissions and the following parameters.

Parameter Description Type Required
message Post message string either message or link
link Post URL string either message or link
picture Post thumbnail image (can only be used if link is specified) string no
name Post name (can only be used if link is specified) string no
caption Post caption (can only be used if link is specified) string no
description Post description (can only be used if link is specified) string no
actions Post actions array of objects containing name and link no

If the create is successful, you get the following return.

Name Description Type
id The new post ID string

statuses

Create

You can post a status message on a Group's wall by issuing an HTTP POST request to GROUP_ID/feed with the publish_stream permissions and the following parameters.

Parameter Description Type Required
message Status Message content string yes

If the create is successful, you get the following return.

Name Description Type
id The new status message ID string
Updated about a month ago
Facebook © 2012 · English (US)
AboutCareersPlatform PoliciesPrivacy Policy