API de agendamentoAPI

Agende um post com um único campo

Envie o mesmo corpo que usaria para publicar agora, adicione um timestamp schedule_at e o FoPost guarda o post na fila até lá. Tudo continua editável até o momento da publicação, e a entrega é informada por conta.

Obtenha sua chave de APILer a documentação
POST /v1/posts
curl -X POST https://api.fopost.com/v1/posts \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "9b2f6c1e-...",
    "status": "scheduled",
    "schedule_at": "2026-09-01T09:00:00Z",
    "content": [{ "text": "Webhook retries are live. Read the changelog." }],
    "accounts": ["4a71d80b-...", "c30e9f12-..."]
  }'

Um único timestamp

Qualquer horário ISO 8601 no futuro. A fila recebe o post e publica no horário.

Editável até o envio

Use PUT no texto, na mídia, nas contas ou no horário de qualquer item ainda na fila.

Entrega por conta

Quando o post sai, cada conta informa seu próprio status e permalink.

Fila de publicação

Planeje uma semana de posts em um único script

Percorra seu conteúdo, escolha um horário para cada item e crie os posts. A fila roda no FoPost, então seu processo pode encerrar assim que a requisição retornar. Liste os posts agendados quando quiser para ver o que vem por aí.

Ler a referência de posts
GET /v1/posts?status=scheduled
curl "https://api.fopost.com/v1/posts?workspace_id=9b2f6c1e-...&status=scheduled" \
  -H "X-API-Key: $API_KEY"

{
  "data": [
    { "id": "7d3e0a52-...", "status": "scheduled", "schedule_at": "2026-09-01T09:00:00Z", "accounts": [{ "id": "4a71d80b-...", "platform": "linkedin", "publish_status": "pending" }] },
    { "id": "8e4f1b63-...", "status": "scheduled", "schedule_at": "2026-09-02T09:00:00Z", "accounts": [{ "id": "c30e9f12-...", "platform": "twitter", "publish_status": "pending" }] }
  ],
  "meta": { "page": 1, "per_page": 30, "total": 2, "total_pages": 1 }
}

Filtre por status

Liste posts em rascunho, agendados, publicados ou com falha com um único parâmetro de consulta.

Etiquetas

Marque cada post por campanha e filtre a fila por etiqueta.

Por espaço de trabalho

Uma chave vê um espaço de trabalho, então a fila de um cliente nunca se mistura com a de outro.

Ajuste

Mova, reescreva ou cancele antes de sair

Planos mudam. Use PUT em um post agendado para alterar o horário, o texto, a mídia ou as contas de destino. Cancele e ele fica marcado como cancelado e nunca é entregue, ou exclua de vez. Nada fica bloqueado até a fila assumir o post.

Ver o endpoint PUT
PUT /v1/posts/:id
curl -X PUT https://api.fopost.com/v1/posts/7d3e0a52-... \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "schedule_at": "2026-09-01T14:00:00Z" }'

Reagende

Altere schedule_at e a fila move o post para o novo horário.

Troque o conteúdo

Substitua o array de conteúdo ou os ids de mídia de um post na fila.

Cancele ou exclua

Retire um post da fila sem mexer em mais nada.

Confirme

Saiba quando chegou, sem fazer polling

Na hora agendada, o post se divide em uma entrega por conta. Registre um webhook e delivery.published ou delivery.failed é disparado para cada uma, ou consulte o endpoint de entregas se preferir um modelo de pull.

Comece a construir
Um mês de posts agendados no calendário de publicação

Webhook na conclusão

delivery.published traz o id do post, a conta e o permalink.

Novas tentativas

Erros temporários de rede são repetidos com backoff antes de uma falha ser informada.

Análises depois

Depois que o post entra no ar, o mesmo id lê impressões e engajamento na Analytics API.

Perguntas sobre API de agendamento, respondidas

Com quanta antecedência posso agendar?

Com a antecedência que quiser. Qualquer timestamp ISO 8601 futuro é aceito, e a fila guarda o post até lá.

Qual fuso horário o schedule_at usa?

Envie um timestamp ISO 8601 em UTC, terminando em Z. O valor enviado é o valor executado: nenhuma conversão acontece no servidor.

Posso editar um post depois de agendar?

Sim. Use PUT em qualquer campo, inclusive no horário, de um post que ainda não saiu. Depois de publicado, as edições se aplicam ao registro, e você usa delete para removê-lo de uma rede.

O que acontece se meu servidor estiver fora do ar na hora da publicação?

Nada muda. A fila roda dentro do FoPost, não na sua infraestrutura, então o post sai com seu processo em execução ou não.

Posso agendar para apenas algumas contas?

Sim. O array accounts é a lista de destino. Inclua apenas as contas que devem receber o post, e cada uma ganha seu próprio registro de entrega.

Existe limite de requisições?

Sim, 100 requisições por minuto por chave. Agendar uma semana de posts em um único script cabe com folga nesse limite.

Comece a construir com API de agendamento hoje

Começar é grátis e a API completa está incluída. Crie uma chave e faça sua primeira chamada em minutos.

Obtenha sua chave de API