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

# Pinterest

> Conecte sua conta do Pinterest ao PostClean

O PostClean cria pins de imagem, pins de vídeo e carrosséis no Pinterest.

## Conectar sua conta

1. Na barra lateral, abra **Canais** e clique em **Conectar canal** (ou use **Novo** > **Conectar um novo canal**)
2. Escolha **Pinterest** e clique em **Conectar Pinterest**
3. Autorize o PostClean no Pinterest
4. Na página de confirmação, marque a conta e clique em **Concluir conexão**

O PostClean abre a página **Publicar** do novo canal e pergunta quantas vezes por semana você quer postar. Veja o fluxo completo em [Conectar canais](https://docs.postclean.com.br/knowledge-base/channels/connecting.md).

## Escolha da pasta

O Pinterest exige que todo pin pertença a uma **pasta** (board). Quando você posta num canal do Pinterest, as configurações dele no editor mostram **Fixar em** com uma lista de pastas que dá para pesquisar. Escolha uma pasta, ou digite um nome e clique em **Criar** para fazer uma nova.

Um post sem pasta não pode ser agendado nem publicado: o editor, a [API REST](https://docs.postclean.com.br/api-reference/introduction.md) e o MCP recusam o post pedindo que você selecione uma pasta do Pinterest. Na API, envie a pasta em `meta.board_id`; liste as pastas com [List Pinterest boards](https://docs.postclean.com.br/api-reference/social-accounts/list-pinterest-boards.md) (`GET /social-accounts/{account}/boards`) e crie uma com [Create Pinterest board](https://docs.postclean.com.br/api-reference/social-accounts/create-pinterest-board.md) (`POST /social-accounts/{account}/boards`).

## Tipos de conteúdo

| Tipo | `content_type` | Proporção | Descrição |
| - | - | - | - |
| **Foto** | `pinterest_pin` | 2:3 | Pin de imagem (1 imagem, obrigatória) |
| **Vídeo** | `pinterest_video_pin` | 9:16 | Pin de vídeo de até 15 minutos (1 vídeo, obrigatório) |
| **Carrossel** | `pinterest_carousel` | 2:3 | Pin com várias imagens (de 2 a 5) |

A mídia anexada define o tipo.

## Limites de mídia

| `content_type` | Imagem | Vídeo | Duração | Formato |
| - | - | - | - | - |
| `pinterest_pin` | 10 MB | Não aceita | Não se aplica | JPEG/PNG |
| `pinterest_video_pin` | Não aceita | 1 GB | 15 minutos | MP4 ou MOV |
| `pinterest_carousel` | 10 MB | Não aceita | Não se aplica | JPEG/PNG, de 2 a 5 imagens |

Especificações oficiais: [Creating boards and pins](https://developers.pinterest.com/docs/work-with-organic-content-and-users/create-boards-and-pins/), [Product specs](https://help.pinterest.com/en/business/article/pinterest-product-specs). Catálogo completo: [Mídia](https://docs.postclean.com.br/knowledge-base/media.md#pinterest).

## Texto e opções do post

* **Descrição**: o texto do post, até **800 caracteres**.
* **Título**: título opcional do pin (`meta.title`, até 100 caracteres).
* **Link de destino**: para onde o pin leva (`meta.link`, http ou https, até 2.048 caracteres).
* **Capa do vídeo**: escolha o quadro de capa de um pin de vídeo em **Editar mídia** > **Miniatura**.
* **Texto alternativo**: até 500 caracteres por imagem.

## Insights

Os pins e os seguidores do Pinterest aparecem em [Insights](https://docs.postclean.com.br/knowledge-base/insights/overview.md).

## Escopos OAuth

`boards:read`, `boards:write`, `pins:read`, `pins:write`, `user_accounts:read`

`pins:read` e `user_accounts:read` são necessários para as métricas do Pinterest em Insights. `boards:read` alimenta o seletor de pastas, e `boards:write` permite criar pastas.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.