API actions for the Pinterest integration.
Create pins on boards in your Pinterest account.
Create a pin
Publish a new pin to a Pinterest board using the connected account.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
board_id | string | Yes | The ID of the board to add the pin to. |
media_url | string | Yes | Web address of the image to use for the pin. Pinterest requires the image to be publicly accessible. |
title | string | No | Optional title for the new pin (max 100 characters). |
description | string | No | Optional description or note for the pin (max 800 characters). |
link | string | No | Destination link for the pin. |
Response
{}List boards
List the boards in your Pinterest account, including each board's ID. Use this to find the board ID needed to create a pin.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Maximum number of boards to return (1-100). |
Response
[
{
"id": "549755885175",
"name": "Summer Recipes",
"privacy": "PUBLIC"
}
]