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

CampoTipoObrigatórioDescrição
customer_integrationstringNãoO uuid da conexão do Pinterest, na query. Alternativa ao source_name.
source_namestringNãoO nome da conta do Pinterest (até 255 caracteres). Usado quando não há customer_integration.
namestringSimNome do board, até 180 caracteres.
descriptionstringNãoDescrição do board, até 500 caracteres.
privacystringNãoVisibilidade do board: PUBLIC, PROTECTED ou SECRET.
idstringNãoNa 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.

Relacionadas

Ver tudo que dá para fazer em Posts

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.