Posts

Publicar no perfil pessoal do LinkedIn pela API

Um POST /posts com a conexão linkedin_personal publica no perfil pessoal que a pessoa conectou. Seu produto não implementa o OAuth do LinkedIn nem guarda tokens: envia o conteúdo e o Connect publica em segundo plano, com o mesmo corpo usado para páginas.

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

O que dá para fazer

  • Publicar texto puro, com legenda de até 3000 caracteres.
  • Publicar de 1 a 20 imagens, com alt_text opcional.
  • Publicar 1 vídeo, com título opcional em linkedin.title.
  • Publicar 1 documento, com linkedin.title obrigatório.
  • Escolher o perfil 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

  • Ferramenta de personal branding

    Executivos conectam o perfil pessoal e o produto publica os posts aprovados pela equipe de conteúdo.

  • Plataforma de vendas e social selling

    Vendedores publicam conteúdo da empresa no próprio perfil a partir do CRM, uma conexão por pessoa.

  • Agente de IA para criadores

    Um agente escreve a versão do post para o perfil pessoal e publica depois da aprovação do usuário.

Funciona com

  • LinkedIn Personal

Perguntas frequentes

Perfil pessoal e página usam o mesmo endpoint?

Sim, POST /posts com o mesmo corpo. O que muda é a conexão: linkedin_personal para perfil pessoal e linkedin para páginas.

Posso publicar um carrossel de imagens?

Sim, de 2 a 20 imagens no mesmo post. Vídeo e documento só funcionam sozinhos no post.

E se a mesma publicação for enviada duas vezes?

O Idempotency-Key devolve o post já gravado, e a external_reference retorna 409 se o mesmo post estiver publicando ou já tiver sido publicado na conta.

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.