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
| 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
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.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
