Create pin
pinterest_create_pinPublish an image, carousel, or video pin to a chosen board using a URL, base64 data, or an uploaded media ID, with optional title, link, and alt text.
Instructions
Create a pin on one of the authenticated user's boards. Requires a board_id and a media_source. Scope: pins:write (pins:write_secret for secret boards).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"board_id": "<board_id>",
"media_source": "<media_source>"
},
"name": "pinterest_create_pin"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| link | No | Destination URL opened when the pin is clicked. | |
| note | No | Private note, visible only to the owner. | |
| title | No | Pin title, up to 100 characters. | |
| alt_text | No | Accessibility text describing the image. | |
| board_id | Yes | Board to save the pin to. | |
| description | No | Pin description, up to 800 characters. | |
| media_source | Yes | The pin's media. Pick the variant matching what you have: a URL, base64 bytes, a carousel, or an uploaded video. | |
| ad_account_id | No | Act on behalf of this ad account. Required only for business accounts operating on a shared asset. | |
| dominant_color | No | Hex colour like '#6E7874'. Only for non-video pins. | |
| board_section_id | No | Section within the board. |