Angola
Brasil
Kenya
Moçambique
Nigeria
Portugal
South Africa
United Kingdom
United States
International
A resposta curta: junte ao pedido o campo send_at, com a data e a hora em ISO 8601 e o fuso horário, até 30 dias à frente. Os créditos só são descontados quando o e-mail sair. Para desistir, chame POST /v1/email/messages/{id}/cancel antes da hora.
Quando faz sentido agendar
| Situação | Exemplo |
| Lembrete antes de um prazo | A factura vence na sexta: agende o lembrete para quarta de manhã |
| Fora de horas | Uma encomenda feita à meia-noite: a confirmação sai logo, mas o inquérito de satisfação pode sair no dia seguinte |
| Data marcada | O aviso de que um plano termina, na véspera |
Como escrever a data
Use o formato ISO 8601 com o fuso no fim, como no exemplo da documentação: 2026-11-20T09:30:00+02:00. O +02:00 é o fuso desse exemplo; use o do seu cliente. Sem o fuso, a hora fica ambígua.
"send_at": "2026-11-20T09:30:00+02:00"
| Motivo do erro | O que corrigir |
| invalid_send_at | A data não está em ISO 8601 com o fuso |
| send_at_in_past | A data já passou. Para enviar já, não mande send_at |
| send_at_too_far | A data está demasiado longe: o máximo são 30 dias |
Cancelar
|
|
|
Só se cancelam os agendados que ainda não saíram. Depois disso, a API responde 409 com o motivo not_cancellable.
| O saldo é conferido outra vez na hora de sair. Se nessa altura não houver créditos, o e-mail não sai e fica failed, com o erro insufficient_credits. Os créditos reservados para agendados vêm em scheduled_credits, em GET /v1/email/balance. |
| Cancele quando o motivo desaparecer. Se o cliente pagou antes do lembrete, o seu sistema cancela o lembrete agendado. Ninguém gosta de receber um aviso de pagamento depois de pagar. |
|
Quer automatizar lembretes por e-mail na hora certa? Veja a página da API. Ver a página da API |
PRODUTO RECOMENDADO E-mail profissional no seu domínio Caixas com o nome da sua empresa, sem publicidade, com filtro de spam. desde 5,94 €/mês (plano de 3 anos, com cupão) Ver planos |
