Facebook Developers
DocsToolsSupportNewsApps
Log In
  • Social Plugins
  • Facebook Login
  • Open Graph
  • Facebook APIs
    • Graph API
    • FQL
    • Open Graph
    • Dialogs
    • Chat
    • Internationalization
    • Ads
  • Games
  • Payments
  • App Center
  • Promote Your App
  • iOS
  • Android
  • JavaScript
  • PHP
  • More SDKs
  • Objects
    • Achievement(Instance)
    • Album
    • Application
    • Checkin
    • Comment
    • Domain
    • Errors
    • Event
    • Field Expansion
    • FriendList
    • Group
    • Insights
    • Link
    • Message
    • Note
    • Offer
    • Order
    • Page
    • Pagination
    • Payment
    • Photo
    • Pictures
    • Post
    • Privacy Parameter
    • Publishing
    • Question
    • QuestionOption
    • Realtime Updates
    • Review
    • Search
    • Selecting Results
    • Status message
    • Thread
    • User
    • Video

Message

Facebook APIs › 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 over a year ago
Facebook © 2013 · English (US)
AboutAdvertisingCareersPlatform PoliciesPrivacy Policy