Graph:Message

An individual message in the new Facebook messaging system. Every message has a message ID that represents an object in the Graph. To get access to read a user's messages, you should request the read_mailbox Extended Permission.

You can GET an individual message by specifying the message ID:

GET https://graph.facebook.com/[message_id]

Or you can GET all the messages in a thread:

GET https://graph.facebook.com/[thread_id]/messages

Properties

Name	Description	Permissions	Returns	Condition
id	The unique ID for this message	read_mailbox	A JSON string
from	The sender of this message	read_mailbox	A JSON object that contains the name, email and Facebook id (if available) of the sender
to	A list of the message recipients	read_mailbox	A list of JSON objects, each of which contains the name, email and Facebook id of the recipient
message	The text of the message	read_mailbox	A JSON string
created_time	A timestamp of when this message was created	read_mailbox	A JSON string containing a IETF RFC 3339 datetime

Connections

Name	Description	Permissions	Returns
attachments	A list attachments	read_mailbox	Contains in data a list of JSON objects each of which have id, mime_type, name and size as fields
shares	A list of attached shares	read_mailbox	Contains in data a list of JSON objects each of which have id, link, name, description and picture as fields