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

CampoTipoObrigatórioDescrição
external_referencestringSimO id do post no seu sistema (até 100 caracteres). Impede publicar o mesmo post duas vezes na mesma conta.
formatstringSimSempre feed no LinkedIn.
captionstringNãoO texto do post, até 3000 caracteres. Obrigatório quando não há mídia.
mediaarrayNãoImagens (1 a 20), ou 1 vídeo, ou 1 documento. Vídeo e documento não se misturam com outras mídias.
media.typestringSimimage, video ou document. Documento (por exemplo um PDF) só existe no LinkedIn.
media.urlstringSimURL https:// pública que a rede consiga baixar.
linkedin.titlestringNãoTí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.

Relacionadas

Ver tudo que dá para fazer em Posts

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.