Push API \ Publish a pin on Pinterest

Resource/URI GET POST PUT DELETE
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 · Publish a video on a page 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>/pinterest/pin.json to post a new pin on behalf of a Pinterest user. The <identity_token> is obtained whenever one of your users connects using a social network account.

To be able to use this endpoint, Pinterest must be fully configured for your OneAll Site. The option Publish Actions must be enabled and the user must have given consent to publish content on his behalf when he logged in with Pinterest.

POST data to include in the request

    {
      "request": {
        "push": {
          "pin": {
            "board": "#board-name#",
            "picture": "#picture#",
            "description": "#description#",
            "link": "#link#"            
          }
        }
      }
    }
Key Description
*#board-name# The board on which to post the Pin. A list with the user's boards can be retrieved using our Pull API.
Example: photos
*#picture# The fully qualified URL of the picture to share.
Example: https://www.fcbarcelona.com/stadium.jpg
*#description# The description of the picture being shared.
Example: Photo of the stadium
#link# The fully qualified URL of the link to share.
Example: https://www.fcbarcelona.com/

Result: the code returned by the API

Resultset Example

{
  "response": {
    "request": {
      "date": "Fri, 25 Jan 2018 12:00:53  0200",
      "resource": "/push/identities/12345678-ABCD-WXYZ-1234-ABCABCABCABC/pinterest/pin.json",
      "status": {
        "flag": "success",
        "code": 200,
        "info": "Your request has been processed successfully"
      }
    },
    "result": {
      "data": {
          "provider": "pinterest",
          "object": "pin",
          "pin_id": "123456789012345678",
          "pin_location": "https://www.pinterest.com/pin/123456789012345678/",
          "pin_description": "My note",
          "pin_link": "https://www.pinterest.com/r/pin/123456789/987654321/123456789abcdef"
      }
    }
  }
}
	

User Contributed Notes