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
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| external_reference | string | Oui | L'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. |
| format | string | Oui | Toujours feed sur Pinterest. |
| caption | string | Non | La description du pin, 800 caractères max. |
| media | array | Oui | Exactement 1 image ou 1 vidéo. alt_text va jusqu'à 500 caractères. |
| pinterest.board_id | string | Oui | Le tableau où le pin est enregistré (chaîne numérique, 50 caractères max). Vient de GET /posts/pinterest/boards. |
| pinterest.board_section_id | string | Non | La section du tableau. Vient de GET /posts/pinterest/boards/{board_id}/sections. |
| pinterest.title | string | Non | Titre du pin, 100 caractères max. |
| pinterest.link | string | Non | URL de destination au clic sur le pin (http ou https). |
| pinterest.cover_url | string | Non | Couverture 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.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
