Posts
Publier sur un profil personnel LinkedIn via l'API
Un POST /posts avec la connexion linkedin_personal publie sur le profil personnel que la personne a connecté. Votre produit n'implémente pas l'OAuth de LinkedIn et ne stocke aucun token : il envoie le contenu et Connect publie en arrière-plan, avec le même corps que pour les pages.
L'appel
POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>
{
"external_reference": "post-7002",
"format": "feed",
"caption": "Three lessons from a year of building in public.",
"media": [
{
"type": "image",
"url": "https://cdn.example.com/lessons.png",
"alt_text": "Slide with three lessons"
}
]
}Ce que vous pouvez faire
- Publier du texte seul, avec une légende de 3000 caractères maximum.
- Publier de 1 à 20 images, avec alt_text optionnel.
- Publier 1 vidéo, avec un titre optionnel dans linkedin.title.
- Publier 1 document, avec linkedin.title obligatoire.
- Choisir le profil par la connexion (customer_integration) ou par le nom (integration_slug et source_name).
Règles et limites
- Les pages utilisent la connexion linkedin (integration_slug linkedin). Les profils personnels utilisent linkedin_personal.
- Sur LinkedIn, seul le format feed existe. Il accepte du texte seul (avec légende), 1 à 20 images, 1 vidéo seule ou 1 document seul.
- La légende va jusqu'à 3000 caractères. linkedin.title ne vaut qu'avec 1 vidéo ou 1 document, et il est obligatoire sur un document.
- POST /posts répond 202 et la publication se fait ensuite. Suivez-la avec GET /posts/{uuid}.
- external_reference est obligatoire : la même référence en cours de publication ou déjà publiée sur le même compte retourne 409. Le header Idempotency-Key renvoie le post déjà enregistré en cas de répétition.
Champs principaux
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| external_reference | string | Oui | L'id du post dans votre système (100 caractères max). Évite de publier deux fois le même post sur le même compte. |
| format | string | Oui | Toujours feed sur LinkedIn. |
| caption | string | Non | Le texte du post, 3000 caractères max. Obligatoire sans média. |
| media | array | Non | Images (1 à 20), ou 1 vidéo, ou 1 document. Une vidéo ou un document ne se mélange pas à d'autres médias. |
| media.type | string | Oui | image, video ou document. Un document (par exemple un PDF) n'existe que sur LinkedIn. |
| media.url | string | Oui | URL https:// publique que le réseau peut télécharger. |
| linkedin.title | string | Non | Titre de la vidéo ou du document (255 caractères max). Seulement avec 1 vidéo ou 1 document seul ; obligatoire sur un document. |
Pour qui
Outil de personal branding
Les dirigeants connectent leur profil personnel et le produit publie les posts validés par l'équipe contenu.
Plateforme de vente et social selling
Les commerciaux publient du contenu de l'entreprise sur leur propre profil depuis le CRM, une connexion par personne.
Agent IA pour créateurs
Un agent rédige la version du post pour le profil personnel et la publie après validation de l'utilisateur.
Fonctionne avec
LinkedIn Personal
Questions fréquentes
Profil personnel et page utilisent-ils le même endpoint ?
Oui, POST /posts avec le même corps. Seule la connexion change : linkedin_personal pour un profil personnel et linkedin pour les pages.
Puis-je publier un carrousel d'images ?
Oui, de 2 à 20 images dans le même post. Une vidéo ou un document ne fonctionne que seul dans le post.
Et si le même post est envoyé deux fois ?
L'Idempotency-Key renvoie le post déjà enregistré, et external_reference retourne 409 si le même post est en cours de publication ou déjà publié sur le compte.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
