> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Publish Pin

> Publishes a pin to a Pinterest board: a single image, a carousel of 2 to 5 images, or a video

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**:

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