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

ChampTypeObligatoireDescription
customer_integrationstringNonL'uuid de la connexion Pinterest, dans la query. Alternative à source_name.
source_namestringNonLe nom du compte Pinterest (255 caractères max). Utilisé sans customer_integration.
namestringOuiNom du tableau, 180 caractères max.
descriptionstringNonDescription du tableau, 500 caractères max.
privacystringNonVisibilité du tableau : PUBLIC, PROTECTED ou SECRET.
idstringNonDans 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.

Voir aussi

Voir tout ce que vous pouvez faire avec Posts

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.