Graph API Version

Group Message

Reading

GroupMessage

New Page Experience

This endpoint is supported for New Page Experience.

Feature Permissions

NameDescription
Groups APIThis feature permission may be required.

Example

Graph API Explorer
GET /v10.0/{group-message-id} 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(
    '/{group-message-id}',
    '{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(
    "/{group-message-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{group-message-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{group-message-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
If you want to learn how to use the Graph API, read our Using Graph API guide.

Parameters

This endpoint doesn't have any parameters.

Fields

FieldDescription
id
token with structure: Post ID

id

actions
list

actions

admin_creator
BusinessUser|User|Application

admin_creator

allowed_advertising_objectives
list<string>

allowed_advertising_objectives

application

application

backdated_time
datetime

backdated_time

call_to_action
struct with keys: type, value

call_to_action

can_reply_privately
bool

can_reply_privately

caption
string

caption

child_attachments
list

child_attachments

comments_mirroring_domain
string

comments_mirroring_domain

coordinates
struct with keys: checkin_id, author_uid, page_id, target_id, target_href, coords, tagged_uids, timestamp, message, target_type

coordinates

created_time
datetime

created_time

description
string

description

event

event

expanded_height
unsigned int32

expanded_height

expanded_width
unsigned int32

expanded_width

feed_targeting
struct with keys: country, cities, regions, genders, age_min, age_max, education_statuses, college_years, relationship_statuses, interests, interested_in, user_adclusters, locales, countries, geo_locations, work_positions, work_employers, education_majors, education_schools, family_statuses, life_events, industries, politics, ethnic_affinity, generation, fan_of, relevant_until_ts

feed_targeting

from
User|Page

from

full_picture
string

full_picture

height
unsigned int32

height

icon
string

icon

is_app_share
bool

is_app_share

is_eligible_for_promotion
bool

is_eligible_for_promotion

is_expired
bool

is_expired

is_hidden
bool

is_hidden

is_inline_created
bool

is_inline_created

is_popular
bool

is_popular

is_published
bool

is_published

is_spherical
bool

is_spherical

link
uri

link

message
string

message

message_tags
list

message_tags

multi_share_end_card
bool

multi_share_end_card

multi_share_optimized
bool

multi_share_optimized

name
string

name

object_id
string

object_id

parent_id
token with structure: Post ID

parent_id

permalink_url
uri

permalink_url

place

place

privacy

privacy

promotable_id
token with structure: Post ID

promotable_id

properties
list

properties

scheduled_publish_time
float

scheduled_publish_time

shares
struct with keys: count

shares

source
string

source

status_type
string

status_type

story
string

story

story_tags
list

story_tags

subscribed
bool

subscribed

target

target

targeting
struct with keys: country, cities, regions, zips, genders, college_networks, work_networks, age_min, age_max, education_statuses, college_years, college_majors, political_views, relationship_statuses, interests, keywords, interested_in, user_clusters, user_clusters2, user_clusters3, user_adclusters, excluded_user_adclusters, custom_audiences, excluded_custom_audiences, locales, radius, connections, excluded_connections, friends_of_connections, countries, excluded_user_clusters, adgroup_id, user_event, qrt_versions, page_types, user_os, user_device, action_spec, action_spec_friend, action_spec_excluded, geo_locations, excluded_geo_locations, targeted_entities, conjunctive_user_adclusters, wireless_carrier, site_category, work_positions, work_employers, education_majors, education_schools, family_statuses, life_events, behaviors, travel_status, industries, politics, markets, income, net_worth, home_type, home_ownership, home_value, ethnic_affinity, generation, household_composition, moms, office_type, interest_clusters_expansion, dynamic_audience_ids, product_audience_specs, excluded_product_audience_specs, exclusions, flexible_spec, engagement_specs, excluded_engagement_specs

targeting

timeline_visibility
string

timeline_visibility

type
string

type

updated_time
datetime

updated_time

via
User|Page

via

width
unsigned int32

width

Edges

EdgeDescription

attachments

comments

dynamic_posts

insights

reactions

sharedposts

sponsor_tags

to

Error Codes

ErrorDescription
100Invalid parameter
190Invalid OAuth 2.0 Access Token
368The action attempted has been deemed abusive or is otherwise disallowed
200Permissions error

Creating

You can't perform this operation on this endpoint.

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.