Thread
Please note: We are in the process of making the new messages system available to all users, at which point this API will replace the /inbox/ Graph API endpoint. We are providing early access to this API for registered developer accounts only until the new messaging system is broadly available. You should use the /inbox endpoint for production applications at the current time.
A message thread in the new Facebook messaging system as represented in the Graph API. The User object has a threads connections.
To read a thread, issue an HTTP GET request to /THREAD_ID with the read_mailbox permission.
Fields
The Thread object has the following fields.
Accessing Thread objects always requires a user session and the read_mailbox extended permission.
| Name | Description | Permissions | Returns |
id | The unique ID for this message thread |
|
|
snippet | Fragment of the thread for use in thread lists |
|
|
updated_time | Timestamp of when the thread was last updated |
|
|
message_count | Number of messages in the thread |
|
|
unread_count | Number of unread messages in the thread |
|
|
tags | Thread tags |
|
|
participants | List of the thread participants |
|
|
former_participants | List of former thread participants who have unsubscribed from the thread |
|
|
senders | List of participants who have sent a message in the thread |
|
|
messages | List of the message objects contained in this thread |
|
|
Connections
The Thread object has the following connections.
These connections cannot be created or deleted via the Graph API.
| Name | Description | Permissions | Returns |
| tags | Thread tags. |
|
|
| participants | List of the thread participants |
|
|
| former_participants | List of former thread participants who have unsubscribed from the thread |
|
|
| senders | List of participants who have sent a message in the thread |
|
|
| messages | List of the message objects contained in this thread |
|
|
Updated on Friday