Push API \ Publish a pin on Pinterest

Resource/URI @Facebook GET POST PUT DELETE
Publish a post on a Facebook user profile /push/identities/<identity_token>/facebook/post.json Publish
User
Publish a post on a Facebook page /push/identities/<identity_token>/facebook/page/post.json Publish
Page
Upload a picture to Facebook /push/identities/<identity_token>/facebook/picture.json Upload
Picture
Upload a video to Facebook /push/identities/<identity_token>/facebook/video.json Upload
Video
Resource/URI @LinkedIn GET POST PUT DELETE
Publish on a LinkedIn user profile /push/identities/<identity_token>/linkedin/post.json Publish
User
Publish on a LinkedIn company page /push/identities/<identity_token>/linkedin/company/post.json Publish
Company
Resource/URI @Twitter GET POST PUT DELETE
Publish a tweet on Twitter /push/identities/<identity_token>/twitter/post.json Publish
Tweet
Upload a picture to Twitter /push/identities/<identity_token>/twitter/picture.json Upload
Picture
Upload a video to Twitter /push/identities/<identity_token>/twitter/video.json Upload
Video
Resource/URI @Pinterest GET POST PUT DELETE
Publish a pin on Pinterest /push/identities/<identity_token>/pinterest/pin.json Publish
Pin
Resource/URI @YouTube GET POST PUT DELETE
Publish a video on 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