Posts

Publicar en el perfil personal de LinkedIn con la API

Un POST /posts con la conexión linkedin_personal publica en el perfil personal que la persona conectó. Tu producto no implementa el OAuth de LinkedIn ni guarda tokens: envía el contenido y Connect publica en segundo plano, con el mismo cuerpo usado para páginas.

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

Qué puedes hacer

  • Publicar texto puro, con un pie de hasta 3000 caracteres.
  • Publicar de 1 a 20 imágenes, con alt_text opcional.
  • Publicar 1 video, con título opcional en linkedin.title.
  • Publicar 1 documento, con linkedin.title obligatorio.
  • Elegir el perfil 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

  • Herramienta de marca personal

    Los ejecutivos conectan su perfil personal y el producto publica los posts aprobados por el equipo de contenido.

  • Plataforma de ventas y social selling

    Los vendedores publican contenido de la empresa en su propio perfil desde el CRM, una conexión por persona.

  • Agente de IA para creadores

    Un agente escribe la versión del post para el perfil personal y la publica tras la aprobación del usuario.

Funciona con

  • LinkedIn Personal

Preguntas frecuentes

¿El perfil personal y la página usan el mismo endpoint?

Sí, POST /posts con el mismo cuerpo. Cambia la conexión: linkedin_personal para el perfil personal y linkedin para páginas.

¿Puedo publicar un carrusel de imágenes?

Sí, de 2 a 20 imágenes en el mismo post. Un video o documento solo funciona solo en el post.

¿Y si se envía el mismo post dos veces?

El Idempotency-Key devuelve el post ya guardado, y external_reference devuelve 409 si el mismo post está publicando o ya fue publicado en la cuenta.

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.