Push API \ Publish a post on a LinkedIn company page
Push API Resources
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 the following endpoint in order to publish a post an a LinkedIn company page:
POST
/push/identities/<identity_token>/linkedin/company/post.json
The <identity_token>
is obtained whenever one of your users connects using his LinkedIn account.
To use this endpoint the permission Share Company Pages (w_organization_social) 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/company/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/" } } } }