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
| 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
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.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
