Um endpoint, quatro modos
draft: true salva para aprovação. Um scheduled_at em ISO 8601 publica num instante exato. scheduled_at: "queue" usa o próximo horário recorrente disponível. Sem nenhum dos dois, a entrega começa imediatamente.
POST /api/posts
Publique em várias redes sociais com uma única chamada.
Uma chamada para POST /api/posts recebe o corpo do post, a lista de perfis de destino e a mídia, e devolve status de entrega por destino — não um genérico "enviado". Adicione um Idempotency-Key e a mesma requisição fica segura para repetir por 72 horas se a conexão cair no meio do caminho.
Um endpoint para todas as redes Retentativa segura por idempotência Status por destino, não só um 202
Como o endpoint funciona
Um envelope de post, quatro formas de disparar
Opções por plataforma, sem forkar o request
Campos específicos de cada rede social ficam em post.options.<plataforma> — por exemplo, o board de destino no Pinterest ou a visibilidade no LinkedIn. Use body_overrides quando um destino precisar de um texto diferente do restante do post.
Retentativa segura com Idempotency-Key
Um Idempotency-Key estável torna a requisição lógica segura para repetir por 72 horas. Se a resposta se perder por timeout de rede, reenviar não cria um post duplicado.
ExemploUm post,
Um post,
três destinos diferentes
A resposta traz o status agregado do post e o array targets, com o resultado de cada perfil individualmente — inclusive quando parte dos destinos falha e parte publica (partial). O ciclo completo de cada estado está descrito na API de publicação.
/api/posts202 Acceptedcurl -X POST https://postgate.studio/api/posts \
-H "Authorization: Bearer $POSTGATE_API_KEY" \
-H "Idempotency-Key: launch-post-001" \
-d '{
"post": {
"body": "Confira a história completa do lançamento.",
"options": {
"pinterest": { "board_id": "12345", "title": "Lançamento" },
"linkedin": { "visibility": "PUBLIC" },
"body_overrides": { "instagram": "Lançamento ✨" }
}
},
"profiles": ["pro_pinterest", "pro_linkedin", "pro_instagram"]
}'Antes de publicar
Mídia, agendamento e mais uma rede a cada chamada
01
Anexe mídia com o mesmo request
URL pública, arquivo em base64 ou um ID de mídia pré-processado — veja a documentação de mídia para arquivos grandes ou reutilizados.
02
Ou agende para depois
O mesmo post.body e a mesma lista de profiles alimentam um agendamento recorrente. Veja o agendador de posts via API.
03
Um contrato para toda rede social
O mesmo formato de post vale para Instagram, TikTok, LinkedIn, Facebook, YouTube, Pinterest e Threads. Veja a API unificada de redes sociais.
Comece a construir com o PostGate
Sandbox gratuito, documentação completa e uma API para cada rede social que os seus clientes usam.