Posts
Créer et lister des tableaux Pinterest via l'API
Un pin a besoin d'un tableau. Avec POST /posts/pinterest/boards, votre produit crée le tableau sur le compte que le client a connecté, et avec GET /posts/pinterest/boards il liste les existants, en direct. Connect gère le token Pinterest.
L'appel
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"
}Ce que vous pouvez faire
- Créer un tableau avec nom, description et confidentialité.
- Lister les tableaux du compte en temps réel, avec id, name, description et privacy.
- Choisir le compte par la connexion (customer_integration) ou par le nom (source_name).
- Lister les sections d'un tableau avec GET /posts/pinterest/boards/{board_id}/sections.
- Utiliser l'id du tableau créé comme pinterest.board_id dans POST /posts.
Règles et limites
- POST /posts/pinterest/boards répond 201 avec le tableau créé : id, name, description et privacy.
- name est obligatoire et va jusqu'à 180 caractères. description va jusqu'à 500. privacy accepte PUBLIC, PROTECTED ou SECRET.
- Le compte est indiqué par customer_integration dans la query ou par source_name dans le corps, jamais les deux.
- La liste est en direct, issue du compte Pinterest du client, et non une copie conservée dans Connect.
Champs principaux
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| customer_integration | string | Non | L'uuid de la connexion Pinterest, dans la query. Alternative à source_name. |
| source_name | string | Non | Le nom du compte Pinterest (255 caractères max). Utilisé sans customer_integration. |
| name | string | Oui | Nom du tableau, 180 caractères max. |
| description | string | Non | Description du tableau, 500 caractères max. |
| privacy | string | Non | Visibilité du tableau : PUBLIC, PROTECTED ou SECRET. |
| id | string | Non | Dans la réponse 201, l'id du tableau créé. Utilisez-le comme pinterest.board_id à la publication. |
Pour qui
Onboarding de marque
À la connexion de Pinterest, votre produit crée automatiquement les tableaux de base de la marque (collections, lancements).
Catalogue organisé par catégorie
Une plateforme e-commerce crée un tableau par catégorie de produit puis publie les pins dans chacun.
Agent IA de curation
Un agent vérifie si le tableau du thème existe, le crée sinon et y publie le pin.
Fonctionne avec
Pinterest
Questions fréquentes
Dois-je créer le tableau avant de publier un pin ?
Un pin a besoin d'un pinterest.board_id. Vous pouvez utiliser un tableau existant, listé par GET /posts/pinterest/boards, ou en créer un.
Quelle différence entre PUBLIC, PROTECTED et SECRET ?
C'est la visibilité du tableau sur Pinterest. Connect transmet la valeur envoyée dans privacy.
Comment lister les tableaux ?
Appelez GET /posts/pinterest/boards avec customer_integration ou source_name. La réponse contient la liste des tableaux du compte.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
