Posts

Publicar en páginas de LinkedIn con la API

Un POST /posts con la conexión linkedin publica en la página de empresa que el cliente conectó. No pasas por el OAuth de LinkedIn ni guardas tokens: envías el contenido y Connect publica en segundo plano, en el mismo endpoint de las otras redes.

La llamada

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"
  }
}

Qué puedes hacer

  • Publicar texto puro, con un pie de hasta 3000 caracteres.
  • Publicar de 1 a 20 imágenes en un post.
  • Publicar 1 video, con título opcional en linkedin.title.
  • Publicar 1 documento (un PDF, por ejemplo), con linkedin.title obligatorio.
  • Elegir la página por la conexión (customer_integration) o por el nombre (integration_slug y source_name).

Reglas y límites

  • Las páginas usan la conexión linkedin (integration_slug linkedin). Los perfiles personales usan linkedin_personal.
  • En LinkedIn solo existe el format feed. Acepta texto puro (con pie), 1 a 20 imágenes, 1 video solo o 1 documento solo.
  • El pie llega hasta 3000 caracteres. linkedin.title solo vale con 1 video o 1 documento, y es obligatorio en el documento.
  • POST /posts responde 202 y la publicación corre después. Síguela con GET /posts/{uuid}.
  • external_reference es obligatoria: la misma referencia publicando o ya publicada en la misma cuenta devuelve 409. El header Idempotency-Key devuelve el post ya guardado en una repetición.

Campos principales

CampoTipoObligatorioDescripción
external_referencestringSíEl id del post en tu sistema (hasta 100 caracteres). Evita publicar el mismo post dos veces en la misma cuenta.
formatstringSíSiempre feed en LinkedIn.
captionstringNoEl texto del post, hasta 3000 caracteres. Obligatorio cuando no hay medios.
mediaarrayNoImágenes (1 a 20), o 1 video, o 1 documento. Un video o documento no se mezcla con otros medios.
media.typestringSíimage, video o document. Un documento (por ejemplo un PDF) solo existe en LinkedIn.
media.urlstringSíURL https:// pública que la red pueda descargar.
linkedin.titlestringNoTítulo del video o documento (hasta 255 caracteres). Solo con 1 video o 1 documento solo; obligatorio en el documento.

Para quién

  • Plataforma de employer branding

    Cada empresa cliente conecta su propia página y publica vacantes y novedades desde tu producto.

  • Agencia con varias cuentas

    El panel de la agencia publica el mismo contenido en las páginas de varios clientes, una llamada por cuenta.

  • Agente de IA de contenido

    Un agente convierte un informe en PDF y publica el documento en la página de la empresa con título y pie.

Funciona con

  • LinkedIn

Preguntas frecuentes

¿Necesito una app aprobada por LinkedIn?

No. El cliente conecta la página por el flujo de conexión de Connect y tú publicas con el Bearer del merchant y el x-customer-token.

¿Cómo publico un PDF?

Envía un medio con type document y la URL https del archivo, solo en el post, y completa linkedin.title, que es obligatorio en el documento.

¿Qué diferencia hay con el perfil personal?

La página usa la conexión linkedin y el perfil personal usa linkedin_personal. El cuerpo de POST /posts es el mismo.

Relacionadas

Ver todo lo que puedes hacer con Posts

Mira Connect aplicado a tu producto.

Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.