Posts
Publicar em páginas do LinkedIn pela API
Um POST /posts com a conexão linkedin publica na página de empresa que o cliente conectou. Você não passa pelo OAuth do LinkedIn nem guarda tokens: envia o conteúdo e o Connect publica em segundo plano, no mesmo endpoint das outras redes.
A chamada
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"
}
}O que dá para fazer
- Publicar texto puro, com legenda de até 3000 caracteres.
- Publicar de 1 a 20 imagens em um post.
- Publicar 1 vídeo, com título opcional em linkedin.title.
- Publicar 1 documento (PDF, por exemplo), com linkedin.title obrigatório.
- Escolher a página pela conexão (customer_integration) ou pelo nome (integration_slug e source_name).
Regras e limites
- Páginas usam a conexão linkedin (integration_slug linkedin). Perfis pessoais usam linkedin_personal.
- Só o format feed existe no LinkedIn. Aceita texto puro (com legenda), 1 a 20 imagens, 1 vídeo sozinho ou 1 documento sozinho.
- A legenda vai até 3000 caracteres. O linkedin.title só vale com 1 vídeo ou 1 documento, e é obrigatório no documento.
- O POST /posts responde 202 e a publicação roda depois. Acompanhe por GET /posts/{uuid}.
- external_reference é obrigatória: a mesma referência publicando ou já publicada na mesma conta retorna 409. O header Idempotency-Key devolve o post já gravado em uma repetição.
Campos principais
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| external_reference | string | Sim | O id do post no seu sistema (até 100 caracteres). Impede publicar o mesmo post duas vezes na mesma conta. |
| format | string | Sim | Sempre feed no LinkedIn. |
| caption | string | Não | O texto do post, até 3000 caracteres. Obrigatório quando não há mídia. |
| media | array | Não | Imagens (1 a 20), ou 1 vídeo, ou 1 documento. Vídeo e documento não se misturam com outras mídias. |
| media.type | string | Sim | image, video ou document. Documento (por exemplo um PDF) só existe no LinkedIn. |
| media.url | string | Sim | URL https:// pública que a rede consiga baixar. |
| linkedin.title | string | Não | Título do vídeo ou documento (até 255 caracteres). Só com 1 vídeo ou 1 documento sozinho; obrigatório no documento. |
Para quem
Plataforma de employer branding
Cada empresa cliente conecta a própria página e publica vagas e novidades de dentro do seu produto.
Agência com várias contas
O painel da agência publica o mesmo conteúdo nas páginas de vários clientes, uma chamada por conta.
Agente de IA de conteúdo
Um agente transforma um relatório em PDF e publica o documento na página da empresa com título e legenda.
Funciona com
LinkedIn
Perguntas frequentes
Preciso de um app aprovado pelo LinkedIn?
Não. O cliente conecta a página pelo fluxo de conexão do Connect e você publica com o Bearer do merchant e o x-customer-token.
Como publico um PDF?
Envie uma mídia com type document e a URL https do arquivo, sozinha no post, e preencha linkedin.title, que é obrigatório no documento.
Qual a diferença para o perfil pessoal?
A página usa a conexão linkedin e o perfil pessoal usa linkedin_personal. O corpo do POST /posts é o mesmo.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
