Comece aqui

Do primeiro acesso ao post publicado no Instagram em cinco chamadas. Base URL, autenticação e o ciclo completo de uma publicação.

A Postmatic é uma API para publicar e agendar no Instagram sem lidar com OAuth, tokens de longa duração e as regras da Graph API. Você conecta contas profissionais pelo painel ou pelo fluxo de conexão, e publica com uma chamada HTTP.

Tudo acontece sob uma base URL:

Base URL

https://api.uat.postmatic.dev/v1

O que você precisa

Uma conta na Postmatic. Entre no painel com seu e-mail.
Uma conta do Instagram profissional (Business ou Creator). Contas pessoais são recusadas na conexão.
Uma chave de API, criada em Chaves de API no painel. Ela aparece uma única vez; guarde em um cofre de segredos e use só no servidor.

1. Verifique a chave

Toda chamada leva a chave no header x-access-key.

GET /v1/health/auth

curl https://api.uat.postmatic.dev/v1/health/auth \
  -H "x-access-key: pm_live_…"

Resposta

{ "success": true, "project": { "id": "proj_…", "environment": "live" } }

2. Conecte uma conta

Pelo painel, em Contas, ou pela API: peça a URL de autorização, redirecione o usuário e receba-o de volta no seu redirectUri.

GET /v1/connect/instagram

curl "https://api.uat.postmatic.dev/v1/connect/instagram?redirectUri=https://app.exemplo.com/contas" \
  -H "x-access-key: pm_live_…"

Ao terminar, o usuário volta para https://app.exemplo.com/contas?status=connected&integrationId=int_…. O fluxo completo, com profiles e tratamento de erro, está em Contas e profiles.

3. Descubra o `accountId`

GET /v1/connect/integrations

curl https://api.uat.postmatic.dev/v1/connect/integrations \
  -H "x-access-key: pm_live_…"

Resposta (resumida)

{
  "success": true,
  "total": 1,
  "integrations": [
    { "id": "int_…", "platform": "instagram", "displayName": "acme.brand", "authStatus": "active", "status": "connected" }
  ]
}

O id de cada conta é o accountId que você passa ao publicar.

4. Publique

Uma imagem acessível por HTTPS, a legenda e a conta de destino. A resposta chega antes de o post existir no Instagram: a publicação acontece em segundo plano.

API

Da sua aplicação para o Instagram.

Uma chamada para publicar. Uma consulta para acompanhar. Use a linguagem que já faz parte do seu produto.

curl -X POST https://api.uat.postmatic.dev/v1/posts \
  -H "x-access-key: pm_live_…" \
  -H "content-type: application/json" \
  -d '{
    "content": "Olá do Postmatic.",
    "platforms": [{ "platform": "instagram", "accountId": "int_…" }],
    "mediaItems": [{ "type": "image", "url": "https://…/foto.jpg" }],
    "publishNow": true
  }'

Exemplo de publicação imediata. Substitua a chave, o ID da conta conectada e a URL da imagem.

Resposta 202

{
  "success": true,
  "postId": "post_…",
  "status": "pending",
  "platforms": [{ "platform": "instagram", "accountId": "int_…", "status": "queued", "platformPostUrl": null }]
}

5. Acompanhe

Consulte o post até o status chegar a published ou failed. Publicação imediata costuma terminar em menos de dois minutos.

GET /v1/posts/:id

curl https://api.uat.postmatic.dev/v1/posts/post_… \
  -H "x-access-key: pm_live_…"

Em published, cada item de platforms traz o platformPostUrl. Em failed, leia errorCode e errorMessage do destino. Os estados e as regras de agendamento estão em Publicações.

Próximos passos

Autenticação: os dois modos de acesso, limites de requisição e o envelope de erro.
Mídia: enviar imagens direto para a Postmatic em vez de expor uma URL.
Erros: todos os códigos e o que fazer com cada um.
Referência: spec OpenAPI e a referência interativa de todas as rotas.