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

Note

Facebook APIs › Graph API › Note

A Facebook Note. The User object has a notes connection.

To read a Note you need

  • any valid access_token if it is public
  • user_notes permissions if it is not public and belongs to the user
  • friends_notes permissions if it is not public and belongs to a user's friend

Example

The note announcing Facebook for iPhone 3.0:

https://graph.facebook.com/122788341354


Fields

NameDescriptionPermissionsReturns
id

The note ID

generic access_token or user_notes or friends_notes

string

from

The profile that created the note

generic access_token or user_notes or friends_notes

Object containing id and name fields

subject

The title of the note

generic access_token or user_notes or friends_notes

string

message

The content of the note

generic access_token or user_notes or friends_notes

string containing HTML text

comments

Comments made on the note

generic access_token or user_notes or friends_notes

Array of Comment objects

created_time

The time the note was initially published

generic access_token or user_notes or friends_notes

string containing ISO-8601 date-time

updated_time

The time the note was last updated

generic access_token or user_notes or friends_notes

string containing ISO-8601 date-time

icon

The icon that Facebook displays with notes

generic access_token or user_notes or friends_notes

string containing a valid URL


Connections

NameDescriptionPermissionsReturns
comments

All of the comments on this note.

Any valid access_token or user_notes or friends_notes.

array of objects containing id, from, message and created_time fields.

likes

The likes on this note.

Any valid access_token or user_notes or friends_notes.

array of objects containing the id and name fields.

comments

Create

You can comment on a Note by issuing an HTTP POST request to NOTE_ID/comments with the publish_stream permission and the user_notes or friends_notes permission as appropriate, using the following parameters.

Parameter Description Type Required
message Comment text string yes

If the create is successful, you get the following return.

Name Description Type
id The new comment ID string

likes

Create

You can like a Note by issuing a HTTP POST request to NOTE_ID/likes connection with the publish_stream permission. No parameters necessary.

If the write is successful, you get the following return.

Description Type
If the like succeeded boolean

Delete

You can unlike a Note by issuing an HTTP DELETE request to the NOTE_ID/likes connection with the publish_stream permission.

If the delete is successful, you get the following return.

Description Type
If the unlike succeeded boolean
Updated over a year ago
Facebook © 2013 · English (US)
AboutAdvertisingCareersPlatform PoliciesPrivacy Policy