Facebook Developers
DocumentationSupportBlogAppsLog In
  • Getting Started
  • Core Concepts
    • Social Design
    • Social Plugins
    • Open Graph
    • Social Channels
    • Authentication
    • Graph API
  • Advanced Topics
  • SDK Reference
  • Tools
  • Concepts
    • Batch Requests
    • Permissions
    • Real-time Updates
  • Objects
    • Achievement(Instance)
    • Album
    • Application
    • Checkin
    • Comment
    • Domain
    • Event
    • FriendList
    • Group
    • Insights
    • Link
    • Message
    • Note
    • Offer
    • Order
    • Page
    • Photo
    • Post
    • Question
    • QuestionOption
    • Review
    • Status message
    • Thread
    • User
    • Video

Message

Core Concepts › Graph API › 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.


Fields

The Message object has the following fields.

Accessing Message objects always requires a user session and the read_mailbox extended permission.

NameDescriptionPermissionsReturns
id

The unique ID for this message

read_mailbox

string

created_time

A timestamp of when this message was created

read_mailbox

string containing ISO-8601 date-time

from

The sender of this message

read_mailbox

Object containing name and Facebook id (if available)

to

A list of the message recipients

read_mailbox

Array of objects each containing name and Facebook id (if available)

message

The text of the message

read_mailbox

string

Updated about 4 months ago
Facebook © 2012 · English (US)
AboutCareersPlatform PoliciesPrivacy Policy