This document refers to a feature that was removed after Graph API v2.5.
Graph API Version

Thread /{thread-id}

A Facebook Messages conversation thread. This endpoint is only accessible for users that are developers of the app making the request. Pages should use the Conversation object.

Reading

Graph API Explorer
GET /v2.8/{thread-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'GET',
  '/{thread-id}'
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
/* make the API call */
FB.api(
    "/{thread-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{thread-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{thread-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Permissions

  • A page access token with read_pages_mailbox permission for any threads involving that person.
  • The user must be a tester, developer, or admin of the app making the request.

Fields

NameDescriptionType

id

The unique ID for this message thread.

string

comments

The messages in this thread.

Message[]

to

Profiles that are subscribed to the thread.

Profile[]

unread

The amount of messages that are unread by the session profile.

integer

unseen

The amount of messages that are unseen by the session profile.

integer

updated_time

When the thread was last updated.

datetime

Publishing

You can't create a thread using the Graph API.

Deleting

You can't delete a thread using the Graph API.

Updating

You can't update a thread using the Graph API.