Posting to Pinterest using the Hootsuite API

This guide describes how to schedule pins to Pinterest using the Hootsuite REST API. For more information about publishing to Pinterest using Hootsuite, including adding Pinterest as a social profile, see our HelpDesk Article here.

1. Retrieve your Pinterest Social Profile ID

In order to post to Pinterest, you'll first need to retrieve the socialProfileId for your Pinterest Account. Call the GET /socialProfiles endpoint to retrieve this information.

curl -H "Authorization: Bearer [USER_ACCESS_TOKEN]" \
  -X GET https://platform.hootsuite.com/v1/socialProfiles
{
    "id": "122626596",
    "type": "PINTEREST",
    "socialNetworkId": "360077070115545223",
    "socialNetworkUsername": "appdemo",
    "avatarUrl": "https://i.pinimg.com/30x30_RS/24/b7/2b/24b72be41bb07381cff10213854eab64.jpg",
        "owner": "ORGANIZATION"
}

2. Determine your Pinterest Board ID and Destination URL

At this time, the Hootsuite API doesn't return users' Pinterest Board IDs. You can use various sites that determine your Board ID, or, if building an Application, call the Pinterest API directly to retrieve this information.

Your Destination URL is the URL your Pin will direct users to when clicked on in Pinterest natively. Note that this cannot be a redirect URL.

3. Schedule your Pin to Pinterest

Now that you have all the necessary information, you can schedule your pin to Pinterest using our API! An example of the API call can be found below:

curl -H "Authorization: Bearer [USER_ACCESS_TOKEN]" \
  -X POST https://platform.hootsuite.com/v1/messages \
  -H 'Content-Type: application/json;charset=utf-8' \
  -d '{
  "text": "Scheduling to Pinterest through the Hootsuite API",
  "socialProfileIds": [ 
    {{pinterest_snId}}
  ],
  "scheduledSendTime": "2018-05-08T18:15:00Z",
  "media" : [
    {
        "id" : "aHR0cHM6Ly9ob290c3VpdGUtdmlkZW8uczMuYW1hem9uYXdzLmNvbS9wcm9kdWN0aW9uLzkyMzUwNzNfMjRhZjQxMWEtODY4MS00YzQyLTliYmEtYjg1ZWE1MWE2NWI3LnBuZw=="
    }   
  ]
  "extendedInfo": [
    {
        "socialProfileType": "PINTEREST",
        "socialProfileId": {{pinterest_snId}},
        "data": {
            "boardId": "12345678909876",
            "destinationUrl": "https://www.hootsuite.com"
        }
    }
]
}'

You've now successfully scheduled a message to Pinterest! You'll be able to see it displayed within your Hootsuite Dashboard's Publisher and Planner Tabs.

Updated 2 years ago

Posting to Pinterest using the Hootsuite API


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.