Graph:Message

From Facebook Developer Wiki (FbDevWiki.com)
Jump to: navigation, search

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
Personal tools
Namespaces
Variants
Actions
Navigation
Graph API
FQL
Toolbox