Data e hora exatas
Passe um scheduled_at em ISO 8601 para publicar um post específico num instante futuro, já com o fuso horário da conta considerado.
Um post pode esperar até um instante exato ou entrar numa fila recorrente — a mesma POST /api/posts para publicar agora serve para agendar para depois. E quando o que você precisa é de um modelo que se repete sozinho, o recurso de agendamento cria a fila por trás de cada horário.
Passe um scheduled_at em ISO 8601 para publicar um post específico num instante futuro, já com o fuso horário da conta considerado.
Crie um agendamento com kind: "cron" (expressão cron, em qualquer fuso IANA) ou kind: "slots" (horários fixos como 09:00, 13:30, 18:00). Um post com scheduled_at: "queue" ocupa a próxima vaga disponível.
Um PATCH com active: false para a materialização de novos posts sem apagar o agendamento — retome quando fizer sentido.
O agendamento reusa o mesmo envelope de post, perfis e mídia do POST /api/posts — só que como um modelo que se repete no horário definido.
/api/schedules201 Createdcurl -X POST https://postgate.studio/api/schedules \
-H "Authorization: Bearer $POSTGATE_API_KEY" \
-d '{
"name": "Atualização de dias úteis",
"kind": "cron",
"expression": "0 9 * * 1-5",
"timezone": "America/Sao_Paulo",
"template": {
"post": { "body": "Bom dia da Acme." },
"profiles": ["pro_linkedin456"]
}
}'Cada upload no YouTube exige escolha explícita de privacidade e público — por isso, para esse destino, use posts agendados individualmente em vez de um modelo recorrente. Veja a documentação de plataformas.
Alterar a expressão ou o fuso horário de um agendamento reinicia o horizonte de materialização dos próximos posts — planeje a mudança, não faça isso no meio de uma campanha em andamento.
O modelo aceita a mesma lista de perfis de várias redes que um post normal. Veja postar em várias redes sociais e, para volume, postagem em massa.