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
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| external_reference | string | Sí | El id del post en tu sistema (hasta 100 caracteres). Evita publicar el mismo post dos veces en la misma cuenta. |
| format | string | Sí | Siempre feed en LinkedIn. |
| caption | string | No | El texto del post, hasta 3000 caracteres. Obligatorio cuando no hay medios. |
| media | array | No | Imágenes (1 a 20), o 1 video, o 1 documento. Un video o documento no se mezcla con otros medios. |
| media.type | string | Sí | image, video o document. Un documento (por ejemplo un PDF) solo existe en LinkedIn. |
| media.url | string | Sí | URL https:// pública que la red pueda descargar. |
| linkedin.title | string | No | Tí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.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
