Push API \ Publish a post on a LinkedIn company page

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 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 Video
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
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
Pinterest · Publish a pin on behalf of a user /push/identities/<identity_token>/pinterest/pin.json Publish Pin
YouTube · Publish a video on behalf of a user /push/identities/<identity_token>/youtube/video.json Upload Video

Workflow

Request: the code to send to the API

Send a POST request with the data below to the endpoint /push/identities/<identity_token>/linkedin/company/post.json to post a new message on the page of a LinkedIn company. The <identity_token> is obtained whenever one of your users connects using a social network account.

To use this endpoint the permission Manage Company Pages (rw_organization_admin) must be enabled in the LinkedIn settings in your OneAll account and the user must have granted that permission when he logged in with LinkedIn. You can use our Pull API to retrieve the company pages a user administers.

POST data to include in the request

    {
     "request": {
       "push": {			
         "post": {
           "company": "#company#",
           "title": "#title#",
           "description": "#description#",
           "message": "#message#",
           "link": "#link#",
           "picture": "#picture#"
         }
       }
     }
    }
	
Key Description
* #company# The identifier of the company for which you want to publish the post.
The list of the user's companies can be retrieved using our Pull API.
Example: 223423
#title# The title of the content being shared. No more than 200 characters.
Example: My holiday in Spain!
#description# The description of the content being shared. No more than 256 characters.
Example: Barcelona Football Stadium
#message# A comment to associated with the share. No more than 700 characters.
Example: The absolute best part of my holiday was the Barcelona football stadium
* #link# The fully qualified URL of the link to share.
Example: https://www.fcbarcelona.com/
#picture# The fully qualified URL of the picture to share.
Example: https://www.fcbarcelona.com/stadium.jpg

Result: the code returned by the API

Resultset Example

{
  "response":{
    "request":{
      "date": "Fri, 22 Sep 2017 12:00:53  0200",
      "resource": "/push/identities/498ac3a3-ec9d-4a56-ba4a-0a3f3960145d/linkedin/post.json",
      "status":{
        "flag": "success",
        "code": 200,
        "info": "Your request has been processed successfully"
      }
    },
    "result":{
      "data":{
        "provider": "linkedin",
        "object": "post",
        "post_id": 1234567890123456789,
        "post_key": "urn:li:share:1234567890123456789",
        "post_location": "https://www.linkedin.com/feed/update/urn:li:share:1234567890123456789/"
      }
    }
  }
}
	

User Contributed Notes