Fresh 2026

Conversation /{conversation-id}

A Messenger conversation between a person and a Facebook Page or an Instagram Professional Account.

Reading

HTTPPHP SDKJavaScript SDKAndroid SDKiOS SDK Graph API Explorer

GET /v25.0/{conversation-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(
    '/{conversation-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(
    "/{conversation-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{conversation-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:@"/{conversation-id}"\
                                      parameters:params\
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,\
                                      id result,\
                                      NSError *error) {\
    // Handle the result\
}];

Permissions

• A Page access token requested by a person who can perform the MESSAGING task on the Page being queried

• The pages_messaging permission

• The pages_manage_metadata permission

For Instagram Messaging, you will also need:

• The instagram_basic permission

• The instagram_manage_messages permission

Limitations

• When querying this endpoint for Instagram Messaging, all messages for the conversation will be returned. However, you will only be able to query data for the 20 most recent messages in the conversation. If a message is not within the 20 most recent, an error will be returned stating that the message has been deleted.

Fields

Name	Description
id<br> string	The ID for the conversation
is_owner<br> boolean	Indicates whether the app making this request is the thread owner responsible for replying to the conversation<br>Note: This field will only be returned if the associated Facebook Page or Instagram account has enabled Conversation Routing
messages<br> string	Messages within the conversation
participants<br> object <br>id<br>email<br>Page messaging only<br>name<br>Page messaging only<br>username<br>Instagram Messaging only	Participants in the conversation<br>Instagram-Scoped ID or Page-scoped ID for a person or Instagram ID for your Instagram Professional account or the Page ID.<br>Email for the person or Page<br>Name for the person or Page<br>Instagram username for a person or your Instagram Profession account
updated_time<br> datetime	The time when the last message was added to the conversation

To get information about a specific message within a conversation, send a request to the Message endpoint.

Publishing

You can't publish using this edge.

Use the Messenger Platform to send Templates, Quick Replies, and more.

Deleting

You can't delete using this edge.

Updating

You can't update using this edge.

Edges

Name	Description	Used to Publish
/messages	List of all messages in the conversation	Replies (by Pages only)

``

``