Posts

Publier des pins sur Pinterest via l'API

Un POST /posts avec la connexion pinterest crée un pin sur le tableau de votre choix. Connect liste en direct les tableaux et sections du compte du client, donc votre produit n'implémente pas l'OAuth de Pinterest et ne stocke aucun token.

L'appel

POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>

{
  "external_reference": "pin-3301",
  "format": "feed",
  "caption": "Linen sofa in warm oat. Free shipping this month.",
  "media": [
    {
      "type": "image",
      "url": "https://cdn.example.com/sofa.jpg",
      "alt_text": "Oat linen sofa in a bright living room"
    }
  ],
  "pinterest": {
    "board_id": "<board id>",
    "board_section_id": "<section id>",
    "title": "Oat linen sofa",
    "link": "https://shop.example.com/sofa"
  }
}

Ce que vous pouvez faire

  • Publier un pin image ou un pin vidéo.
  • Lister les tableaux du compte avec GET /posts/pinterest/boards et les sections avec GET /posts/pinterest/boards/{board_id}/sections.
  • Définir le titre, le lien de destination et la description du pin.
  • Enregistrer le pin dans une section précise du tableau avec board_section_id.
  • Renseigner un alt_text de 500 caractères maximum pour l'accessibilité.

Règles et limites

  • Un pin est exactement 1 média (image ou vidéo) et le format est toujours feed.
  • pinterest.board_id est obligatoire. pinterest.cover_url est obligatoire sur un pin vidéo et refusée sur un pin image.
  • En choisissant le compte par nom, seul source_name est utilisé, sans integration_slug.
  • POST /posts répond 202 et la publication se fait ensuite. Suivez-la avec GET /posts/{uuid}.
  • external_reference est obligatoire et le header Idempotency-Key évite de dupliquer la requête.

Champs principaux

ChampTypeObligatoireDescription
external_referencestringOuiL'id du pin dans votre système (100 caractères max). Évite de publier deux fois le même pin sur le même compte.
formatstringOuiToujours feed sur Pinterest.
captionstringNonLa description du pin, 800 caractères max.
mediaarrayOuiExactement 1 image ou 1 vidéo. alt_text va jusqu'à 500 caractères.
pinterest.board_idstringOuiLe tableau où le pin est enregistré (chaîne numérique, 50 caractères max). Vient de GET /posts/pinterest/boards.
pinterest.board_section_idstringNonLa section du tableau. Vient de GET /posts/pinterest/boards/{board_id}/sections.
pinterest.titlestringNonTitre du pin, 100 caractères max.
pinterest.linkstringNonURL de destination au clic sur le pin (http ou https).
pinterest.cover_urlstringNonCouverture du pin. Obligatoire sur un pin vidéo et refusée sur un pin image.

Pour qui

  • E-commerce et catalogues

    La boutique publie chaque nouveau produit en pin sur le tableau de la collection, avec un lien vers la page d'achat.

  • Plateforme de content marketing

    Chaque article publié devient un pin avec image de couverture, titre et lien, dans la bonne section du tableau.

  • Agent IA de réseaux sociaux

    Un agent liste les tableaux du compte, choisit le plus adapté et publie le pin avec description et alt_text générés.

Fonctionne avec

  • Pinterest

Questions fréquentes

Comment trouver le board_id ?

Appelez GET /posts/pinterest/boards avec la connexion du client. La réponse contient id, name, description et privacy de chaque tableau.

Puis-je publier une vidéo ?

Oui : 1 vidéo par pin, avec pinterest.cover_url obligatoire comme couverture.

Combien de médias dans un pin ?

Exactement 1, une image ou une vidéo.

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.