Começo rápido

Crie um token de APICopiar link

No app, abra Organização › Chaves de API e clique em Criar token (donos e admins). Dê um nome, escolha um projeto, a validade e as permissões. Para este guia, marque Ler artigos (articles:read) e Escrever artigos (articles:write).

O valor (pl_live_…) aparece uma vez. Copie e guarde num lugar seguro, como uma variável de ambiente:

export POSTLINE_TOKEN="pl_live_..."

Um token de um projeto já sabe o projeto. Com um token de todos os projetos, mande projectId na query ou no corpo de cada chamada.

Liste os seus artigosCopiar link

curl "https://app.postline.com.br/api/v1/articles?limit=20" \
  -H "Authorization: Bearer $POSTLINE_TOKEN"

A resposta traz os artigos do projeto, do atualizado mais recentemente ao mais antigo. Para a próxima página, mande cursor com o nextCursor; ele é null na última.

{
  "data": [
    {
      "id": "0b9c4e7a-…",
      "projectId": "c3a8f2d0-…",
      "title": "Como reduzir churn nos primeiros 30 dias",
      "status": "approved",
      "slug": "como-reduzir-churn",
      "locale": "pt-BR",
      "scheduledAt": null,
      "publishedAt": null,
      "updatedAt": "2026-10-16T14:02:11.000Z"
    }
  ],
  "nextCursor": null
}

Crie um artigoCopiar link

Mande o corpo em Markdown e, se quiser, título, slug e campos de SEO. Com submit: false ele fica rascunho; sem isso, vai direto para revisão.

curl https://app.postline.com.br/api/v1/articles \
  -H "Authorization: Bearer $POSTLINE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "Onboarding que segura clientes", "markdown": "## Por que o primeiro mês importa\n\nA maior parte do churn acontece antes da segunda fatura.", "submit": false}'

A resposta é 201 Created:

{ "id": "…", "revision": 1, "submitted": false, "droppedImages": [] }

O artigo aparece em Conteúdos, pronto para editar. Escrever pela API é grátis.

Mande para revisão (opcional)Copiar link

curl -X POST https://app.postline.com.br/api/v1/articles/$ARTICLE_ID/submit \
  -H "Authorization: Bearer $POSTLINE_TOKEN"

Quem revisa o projeto é avisado. Daí em diante vale a política de aprovação do projeto.