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
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| customer_integration | string | No | El uuid de la conexión de Pinterest, en el query. Alternativa a source_name. |
| source_name | string | No | El nombre de la cuenta de Pinterest (hasta 255 caracteres). Se usa cuando no hay customer_integration. |
| name | string | Sí | Nombre del tablero, hasta 180 caracteres. |
| description | string | No | Descripción del tablero, hasta 500 caracteres. |
| privacy | string | No | Visibilidad del tablero: PUBLIC, PROTECTED o SECRET. |
| id | string | No | En 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.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
