Meta Developer Docs

Appearance

Fresh 2026

/{user-id}/groups ​

The Facebook groups that a person is a member of.

Reading ​

HTTPPHP SDKJavaScript SDKAndroid SDKiOS SDK Graph API Explorer

GET /v25.0/me/groups HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/me/groups',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/me/groups",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/me/groups",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]\
                               initWithGraphPath:@"/me/groups"\
                                      parameters:params\
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,\
                                      id result,\
                                      NSError *error) {\
    // Handle the result\
}];

Permissions ​

  • Any valid user access token can be used to view the groups that person is a member of that were created by the requesting app.
  • A user access token with user_groups permission is required to view all other groups that person is a member of.

Fields ​

An array of Group objects with the following additional fields:

NameDescriptionType
administratorShown if this person is an admin of the group.boolean
bookmark_orderThis group's place in the list of bookmarks on this person's Facebook homepage.int
unreadA count of the number of unread posts in that group.int

Publishing ​

You can't publish using this edge.

Deleting ​

You can't delete using this edge.

Updating ​

You can't update using this edge.