Criar um post

POST
/api/v1/posts

Cria um post escrito por você, sem custo: text para LinkedIn, parts para X (conferidas com a contagem do próprio X), slides, caption e destinations (instagram, linkedin, tiktok) para carrossel. Num projeto ou a partir de um artigo (articleId).

Permissão: posts:write.

Autorização

apiToken
headerAutorizaçãoBearer <token>

Token de API (pl_live_…) de Organização › Chaves de API, com suas permissões e limite de 60 chamadas por minuto. Um token de projeto trabalha no seu projeto; um token de todos os projetos indica um com projectId.

application/json
  1. body
format*string
Valor em"linkedin""carousel""x"
projectId?string

O projeto, de Listar projetos. Um token de projeto preenche sozinho.

Tamanho1 <= length <= 64
articleId?string

O artigo de origem.

Tamanho1 <= length <= 64
text?string

LinkedIn: o post; a primeira linha é a manchete.

Tamanho1 <= length <= 3000
parts?array<>

X: uma parte é um post, mais de uma é uma thread. Cada uma cabe nos 280 caracteres ponderados do X (um link conta 23, um emoji 2); link só na última.

Itens1 <= items <= 25
slides?array<>

Carrossel: em ordem, a capa, os slides, o fechamento.

Itens3 <= items <= 10
caption?string

Carrossel.

Tamanholength <= 2200
hashtags?array<>
Itensitems <= 30
destinations?array<>

Carrossel: onde vai; os três por padrão.

Itens1 <= items <= 3

Corpo da resposta

Criado

application/json
  1. response
Exemplo de requisição
curl -X POST 'https://app.postline.com.br/api/v1/posts' \  -H 'Authorization: Bearer pl_live_…' \  -H 'Content-Type: application/json' \  -d '{  "format": "linkedin",  "articleId": "0b9c4e7a-5d1f-4c2e-9a8b-3f6e2d1c7b90",  "text": "Most churn happens before the second invoice.\n\nHere is what to fix first.",  "hashtags": [    "saas",    "churn"  ]}'
Exemplo de resposta
{  "id": "3c8e1f20-6a4b-4d7e-9f15-8b2c0d6e4a71",  "revision": 1,  "status": "in_review"}