Posts
Publier sur les pages LinkedIn via l'API
Un POST /posts avec la connexion linkedin publie sur la page entreprise que le client a connectée. Vous ne passez pas par l'OAuth de LinkedIn et ne stockez aucun token : vous envoyez le contenu et Connect publie en arrière-plan, sur le même endpoint que les autres réseaux.
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-7001",
"format": "feed",
"caption": "Our 2026 benchmark report is out. Download the full PDF below.",
"media": [
{
"type": "document",
"url": "https://cdn.example.com/benchmark-2026.pdf"
}
],
"linkedin": {
"title": "2026 benchmark report"
}
}Ce que vous pouvez faire
- Publier du texte seul, avec une légende de 3000 caractères maximum.
- Publier de 1 à 20 images dans un post.
- Publier 1 vidéo, avec un titre optionnel dans linkedin.title.
- Publier 1 document (un PDF, par exemple), avec linkedin.title obligatoire.
- Choisir la page 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
Plateforme de marque employeur
Chaque entreprise cliente connecte sa page et publie offres et actualités depuis votre produit.
Agence multi-comptes
Le tableau de bord de l'agence publie le même contenu sur les pages de plusieurs clients, un appel par compte.
Agent IA de contenu
Un agent transforme un rapport en PDF et publie le document sur la page de l'entreprise avec titre et légende.
Fonctionne avec
LinkedIn
Questions fréquentes
Faut-il une app validée par LinkedIn ?
Non. Le client connecte la page via le flux de connexion de Connect et vous publiez avec le Bearer du merchant et le x-customer-token.
Comment publier un PDF ?
Envoyez un média avec type document et l'URL https du fichier, seul dans le post, et renseignez linkedin.title, obligatoire sur un document.
Quelle différence avec un profil personnel ?
La page utilise la connexion linkedin et le profil personnel utilise linkedin_personal. Le corps de POST /posts est identique.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
