Push API \ Publish Pin On Pinterest

Resource/URI @Facebook GET POST PUT DELETE
Publish Post On Facebook /push/identities/<identity_token>/facebook/post.json Publish
Post
Upload Picture To Facebook /push/identities/<identity_token>/facebook/picture.json Upload
Picture
Upload Video To Facebook /push/identities/<identity_token>/facebook/video.json Upload
Video
Resource/URI @LinkedIn GET POST PUT DELETE
Publish Post On LinkedIn /push/identities/<identity_token>/linkedin/post.json Publish
Post
Resource/URI @Twitter GET POST PUT DELETE
Publish Tweet On Twitter /push/identities/<identity_token>/twitter/post.json Publish
Tweet
Upload Picture To Twitter /push/identities/<identity_token>/twitter/picture.json Upload
Picture
Resource/URI @Pinterest GET POST PUT DELETE
Publish Pin To Pinterest /push/identities/<identity_token>/pinterest/pin.json Publish
Pin
Resource/URI @YouTube GET POST PUT DELETE
Publish Video To YouTube /push/identities/<identity_token>/youtube/video.json Publish
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