Push API \ Publish a post on a Facebook user profile PHP SDK

Resource/URI POST
Facebook · Publish a post on a user's profile /push/identities/<identity_token>/facebook/post.json Publish User Post
Facebook · Upload a picture on behalf of a user /push/identities/<identity_token>/facebook/picture.json Upload User Picture
Facebook · Upload a video on behalf of a user /push/identities/<identity_token>/facebook/video.json Upload User Video
Facebook · Publish a post to a group the user is member of /push/identities/<identity_token>/facebook/group/post.json Publish Group Post
Facebook · Upload a picture to a group the user is member of /push/identities/<identity_token>/facebook/group/picture.json Upload Group Picture
Facebook · Upload a video to a group the user is member of /push/identities/<identity_token>/facebook/group/video.json Upload Group Video
Facebook · Publish a post on a page the user administers /push/identities/<identity_token>/facebook/page/post.json Publish Page Post
Facebook · Upload a picture on behalf of a page that the user administers /push/identities/<identity_token>/facebook/page/picture.json Upload Page Picture
Facebook · Upload a video on behalf of a page that the user administers /push/identities/<identity_token>/facebook/page/video.json Upload Page Video
LinkedIn · Publish a post on a user's profile /push/identities/<identity_token>/linkedin/post.json Publish User Post
LinkedIn · Publish a post on a company page the user administers /push/identities/<identity_token>/linkedin/company/post.json Publish Company Post
Pinterest · Publish a pin on behalf of a user /push/identities/<identity_token>/pinterest/board/<board_id>/pin.json Publish Pin
Pinterest · Publish a board on behalf of a user /push/identities/<identity_token>/pinterest/board.json Publish Board
Twitter · Publish a tweet on a user's timeline /push/identities/<identity_token>/twitter/post.json Publish Tweet
Twitter · Upload a picture on behalf of a user /push/identities/<identity_token>/twitter/picture.json Upload Picture
Twitter · Upload a video on behalf of a user /push/identities/<identity_token>/twitter/video.json Upload Video
YouTube · Publish a video on behalf of a user /push/identities/<identity_token>/youtube/video.json Upload Video
YouTube · Add a video to a playlist /push/identities/<identity_token>/youtube/playlist/<playlist_id>/video.json Add Video to Playlist
YouTube · Create a playlist on behalf of a user /push/identities/<identity_token>/youtube/playlist.json Create Playlist
YouTube · Add a section to a user's channel /push/identities/<identity_token>/youtube/channel/section.json Add Channel Section

Workflow

Request: the code to send to the API

Send an API request to this endpoint in order to publish a message on the timeline of a Facebook account:

POST /push/identities/<identity_token>/facebook/post.json

The <identity_token> is obtained whenever one of your users connects using his Facebook account.

This endpoint is deprecated. On August 1, 2018 Facebook has removed the possibility for third-party apps to share to personal profiles. Alternatively you can use our API to publish posts on pages.

POST data to include in the request

    {
     "request":{
       "push":{			
         "post":{
           "message": "#message#",
           "link": "#link#",
           "attachments":[
             "#picture_id#"
           ]
         }
       }
     }
    }
Key Description
* #message# The message to include in the post.
Example: Hello World!
#link# The link to include in the post.
Example: http://www.oneall.com/
attachments (list) - You can either include a link or attachments but not both at the same time.
#picture_id# The Facebook identifier of a picture to attach to the post. Only one single attachment allowed.
You can upload a new picture by using the following API endpoint.
Example: 10213097336001811

Result: the code returned by the API

Resultset Example

{
  "response":{
    "request":{
      "date": "Thu, 21 Sep 2017 15:56:59  0200",
      "resource": "/push/identities/923843ec-1749-4cc1-988f-d6963f3b1baa/facebook/post.json",
      "status":{
        "flag": "success",
        "code": 200,
        "info": "Your request has been processed successfully"
      }
    },
    "result":{
      "data":{
        "provider": "facebook",
        "object": "post",
        "post_id": "1122334455_10213097383563000",
        "post_location": "https://www.facebook.com/1122334455_10213097383563000"
      }
    }
  }
}

User Contributed Notes