A message thread in the new Facebook messaging system. Every thread has a thread ID that represents an object in the Graph. To get access to read a user's threads, you should request the read_mailbox Extended Permission. This is a read only API.
You can GET individual message threads by specifying the thread ID:
Or you can GET all the threads in a user's inbox:
You can also filter or query threads by tag or query terms:
GET https://graph.facebook.com/[user_id]/threads?q=hello GET https://graph.facebook.com/[user_id]/threads?q=hello&tags=other
For a full list of tags, please see the unified_thread FQL table.
|id||The unique ID for this message thread||read_mailbox||JSON string|
|snippet||Fragment of the thread for use in thread lists||read_mailbox||JSON string|
|updated_time||Timestamp of when the thread was last updated||read_mailbox||JSON string containing a IETF RFC 3339 datetime|
|message_count||Number of messages in the thread||read_mailbox||integer|
|unread_count||Number of unread messages in the thread||read_mailbox||integer|
|tags||Thread tags||read_mailbox||list of JSON strings|
|participants||A list of the thread participants||read_mailbox|| Contains in |
|former_participants||A list of former thread participants who have unsubscribed from the thread||read_mailbox|| Contains in |
|senders||A list of participants who have sent a message in the thread||read_mailbox|| Contains in |
|messages||A list of the message objects contained in this thread||read_mailbox|| A list of |