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

# Pinterest

> Pins, video pins, and carousels. board_id is required to publish.

A board is required to publish. Pick it when you compose the post — [list boards](/docs/api-reference/social-accounts/boards) if you are on the API. How the browser flow works: [Connect accounts](/docs/guides/connect-accounts).

## Content types

| Type      | `content_type`        | Media                      |
| --------- | --------------------- | -------------------------- |
| Pin       | `pinterest_pin`       | 1 image, required. 2:3.    |
| Video pin | `pinterest_video_pin` | 1 video, required. 9:16.   |
| Carousel  | `pinterest_carousel`  | 2–5 images, required. 2:3. |

Pin **description** is the effective caption (`custom_content` or post `content`), not a meta field.

## Meta

| Key                               | Required to publish? |
| --------------------------------- | -------------------- |
| `board_id`                        | **Yes**              |
| `title` (max 100)                 | No                   |
| `link` (`http`/`https`, max 2048) | No                   |

## Limits

| Type           | Image | Video              | Duration   |
| -------------- | ----- | ------------------ | ---------- |
| Pin / carousel | 10 MB | —                  | —          |
| Video pin      | —     | 1 GB (Connect cap) | 15 minutes |