Posts

Crear y listar tableros de Pinterest con la API

Un pin necesita un tablero. Con POST /posts/pinterest/boards tu producto crea el tablero en la cuenta que el cliente conectó, y con GET /posts/pinterest/boards lista los existentes, en vivo. Connect se encarga del token de Pinterest.

La llamada

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"
}

Qué puedes hacer

  • Crear un tablero con nombre, descripción y privacidad.
  • Listar los tableros de la cuenta en tiempo real, con id, name, description y privacy.
  • Elegir la cuenta por la conexión (customer_integration) o por el nombre (source_name).
  • Listar las secciones de un tablero con GET /posts/pinterest/boards/{board_id}/sections.
  • Usar el id del tablero creado como pinterest.board_id en POST /posts.

Reglas y límites

  • POST /posts/pinterest/boards responde 201 con el tablero creado: id, name, description y privacy.
  • name es obligatorio y llega hasta 180 caracteres. description llega hasta 500. privacy acepta PUBLIC, PROTECTED o SECRET.
  • La cuenta se indica con customer_integration en el query o con source_name en el cuerpo, nunca con ambos.
  • El listado es en vivo, directo de la cuenta de Pinterest del cliente, no una copia guardada en Connect.

Campos principales

CampoTipoObligatorioDescripción
customer_integrationstringNoEl uuid de la conexión de Pinterest, en el query. Alternativa a source_name.
source_namestringNoEl nombre de la cuenta de Pinterest (hasta 255 caracteres). Se usa cuando no hay customer_integration.
namestringSíNombre del tablero, hasta 180 caracteres.
descriptionstringNoDescripción del tablero, hasta 500 caracteres.
privacystringNoVisibilidad del tablero: PUBLIC, PROTECTED o SECRET.
idstringNoEn la respuesta 201, el id del tablero creado. Úsalo como pinterest.board_id al publicar.

Para quién

  • Onboarding de marca

    Al conectar Pinterest, tu producto crea automáticamente los tableros base de la marca (colecciones, lanzamientos).

  • Catálogo organizado por categoría

    Una plataforma de e-commerce crea un tablero por categoría de producto y luego publica los pins en cada uno.

  • Agente de IA de curaduría

    Un agente verifica si existe el tablero del tema, lo crea si no existe y publica el pin en él.

Funciona con

  • Pinterest

Preguntas frecuentes

¿Debo crear el tablero antes de publicar un pin?

Un pin necesita un pinterest.board_id. Puedes usar un tablero existente, listado por GET /posts/pinterest/boards, o crear uno nuevo.

¿Qué cambia entre PUBLIC, PROTECTED y SECRET?

Es la visibilidad del tablero en Pinterest. Connect traspasa el valor que envíes en privacy.

¿Cómo listo los tableros?

Llama a GET /posts/pinterest/boards con customer_integration o source_name. La respuesta trae la lista de tableros de la cuenta.

Relacionadas

Ver todo lo que puedes hacer con Posts

Mira Connect aplicado a tu producto.

Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.