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

ChampTypeObligatoireDescription
external_referencestringOuiL'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.
formatstringOuiToujours feed sur LinkedIn.
captionstringNonLe texte du post, 3000 caractères max. Obligatoire sans média.
mediaarrayNonImages (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.typestringOuiimage, video ou document. Un document (par exemple un PDF) n'existe que sur LinkedIn.
media.urlstringOuiURL https:// publique que le réseau peut télécharger.
linkedin.titlestringNonTitre 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.

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.