Posts
Criar e listar boards do Pinterest pela API
Antes de publicar um pin, é preciso um board. Com POST /posts/pinterest/boards seu produto cria o board na conta que o cliente conectou, e com GET /posts/pinterest/boards lista os que já existem, ao vivo. O Connect cuida do token do Pinterest.
A chamada
POST /api/posts/pinterest/boards?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"name": "Summer collection",
"description": "Ideas and products for the season",
"privacy": "PUBLIC"
}O que dá para fazer
- Criar um board com nome, descrição e privacidade.
- Listar os boards da conta em tempo real, com id, name, description e privacy.
- Escolher a conta pela conexão (customer_integration) ou pelo nome (source_name).
- Listar as seções de um board com GET /posts/pinterest/boards/{board_id}/sections.
- Usar o id do board criado em pinterest.board_id no POST /posts.
Regras e limites
- POST /posts/pinterest/boards responde 201 com o board criado: id, name, description e privacy.
- name é obrigatório e vai até 180 caracteres. description vai até 500. privacy aceita PUBLIC, PROTECTED ou SECRET.
- A conta é indicada por customer_integration na query ou por source_name no corpo, nunca pelos dois.
- A listagem é ao vivo, direto da conta do cliente no Pinterest, não uma cópia guardada no Connect.
Campos principais
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| customer_integration | string | Não | O uuid da conexão do Pinterest, na query. Alternativa ao source_name. |
| source_name | string | Não | O nome da conta do Pinterest (até 255 caracteres). Usado quando não há customer_integration. |
| name | string | Sim | Nome do board, até 180 caracteres. |
| description | string | Não | Descrição do board, até 500 caracteres. |
| privacy | string | Não | Visibilidade do board: PUBLIC, PROTECTED ou SECRET. |
| id | string | Não | Na resposta 201, o id do board criado. Use-o como pinterest.board_id ao publicar. |
Para quem
Onboarding de marca
Ao conectar o Pinterest, seu produto cria os boards padrão da marca (coleções, lançamentos) automaticamente.
Catálogo organizado por categoria
Uma plataforma de e-commerce cria um board por categoria de produto e depois publica os pins em cada um.
Agente de IA de curadoria
Um agente verifica se o board do tema existe, cria quando não existe e publica o pin nele.
Funciona com
Pinterest
Perguntas frequentes
Preciso criar o board antes de publicar um pin?
O pin precisa de um pinterest.board_id. Você pode usar um board existente, listado por GET /posts/pinterest/boards, ou criar um novo.
O que muda entre PUBLIC, PROTECTED e SECRET?
É a visibilidade do board no Pinterest. O Connect repassa o valor que você enviar em privacy.
Como listo os boards?
Chame GET /posts/pinterest/boards com customer_integration ou source_name. A resposta traz a lista de boards da conta.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
