Platforms
Create Pinterest pins with an image or video on a chosen board, with title and link; limits, options and credit cost.
Sandbox
In the sandbox these options are validated exactly as in production, but nothing is posted: each target gets a simulated result and a preview page. The outcomes described here (for example board placement and link attribution) are production behaviour and apply once live platform access opens.
Use "platform": "pinterest". Every pin goes to a board, so boardId is required.
content).platformSpecificData| Field | Type | Description |
|---|---|---|
boardId | string | Required. The board to pin to. |
title | string | Pin title, up to 100 characters. Defaults to the first line of content. |
link | string | https:// URL the pin opens. |
altText | string | Image description, up to 500 characters. |
dominantColor | string | Hex placeholder color, for example "#6E7874". |
coverImageUrl | string | Cover image URL for video pins. |
{
"content": "10 design tips for modern landing pages",
"platforms": [{
"platform": "pinterest",
"accountId": "acc_8p1q4r7s0t3u6v9w2x5y8z1a",
"platformSpecificData": { "boardId": "1143210755351402924", "title": "10 Design Tips", "link": "https://example.com/design-tips" }
}],
"mediaItems": [{ "type": "image", "url": "https://cdn.example.com/pin.jpg" }],
"publishNow": true
}1 credit per Pinterest target.