Publish Pin - Markifact

Publishes a pin to a Pinterest board: a single image, a carousel of 2 to 5 images, or a video. Takes a title, description, and the destination link the pin sends people to. Markifact handles the transfer to Pinterest, so any reachable media URL works, including Google Drive share links. Call pinterest_list_boards first to get the board id.


App	Pinterest Organic
Operation ID	`pinterest_publish_pin`
Type	Action
Connection	`pinterest` (required)
Credits per run	2
Agent / MCP tool	Yes
Requires approval	Yes (write operation)

Inputs

Field	Type	Required	Default	Description
`board`	string or SelectItem	Yes	-	The board to pin to. Accepts a board id, which pinterest_list_boards returns. Ask the user which board if it is not provided.
`board_section`	string	No	-	Optional board section id to file the pin under, within the chosen board.
`pin_type`	string or SelectableOption	No	`image`	What to pin. Available options: ‘image’ (one image), ‘carousel’ (2 to 5 images viewers swipe through) or ‘video’.
`image_urls`	string or array of string	No	-	The image to pin: exactly one URL for ‘image’ posts, or 2 to 5 URLs for ‘carousel’ posts as a list or one string separated by commas or new lines. Pinterest downloads them, so they must be publicly reachable. Accepts direct URLs or Google Drive share links with sharing set to ‘Anyone with the link’.
`video_url`	string	No	-	The video to pin, required for ‘video’ pins. Markifact uploads it to Pinterest, so any reachable video URL works, including Google Drive share links.
`cover_image_url`	string	No	-	Cover image for video pins, which Pinterest shows as the thumbnail.
`title`	string	No	-	The pin title, up to 100 characters.
`description`	string	No	-	The pin description, up to 800 characters. Keywords here drive how Pinterest surfaces the pin in search.
`link`	string	No	-	The destination URL the pin sends people to when clicked, which is how Pinterest drives traffic. Leave empty for a pin with no link.
`alt_text`	string	No	-	Description of the image for screen readers, up to 500 characters.

SelectItem

Field	Type	Required	Default	Description
`value`	string	Yes	-	The value of the selectable item.
`label`	string	Yes	-	The label of the selectable item, used for display purposes. If not provided, defaults to the value.

SelectableOption

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

Output

Type: Dict Returns the new pin’s id and URL. Video pins are uploaded and processed before the pin is created, so the node waits for Pinterest to finish. Fields: pin_id, pin_url, pin_type, board_id, title, created_at Example:

{
  "pin_id": "813744226420795884",
  "pin_url": "https://www.pinterest.com/pin/813744226420795884/",
  "pin_type": "image",
  "board_id": "549755885175",
  "title": "Autumn recipes"
}