Receber e-mails: Agendamento
Agendar envio
Escreva o e-mail agora e envie depois. Ele fica na pasta Scheduled até a hora que você escolher.
https://g.sendcorex.com/v1command: schedule_sendTudo o que pode ser verificado é verificado agora (destinatário, assunto, e-mail original, anexos), para você saber antes da hora chegar. Créditos e o limite diário são verificados no envio.
Se o envio for recusado nessa hora (sem créditos, limite diário, spam), nada se perde: o e-mail volta para Rascunhos com o motivo.
Destinatários que recusaram o rastreamento na página de preferências nunca são rastreados, mesmo com true.
E-mails enviados pela caixa não levam o cabeçalho List-Unsubscribe nem link de descadastro, a menos que você envie unsubscribe: true, porque são e-mails pessoais.
Toda pessoa que recebe um e-mail da caixa vira contato na lista “Webmail” da conta e passa a ser trusted nesta caixa: as respostas dela vão para a Inbox e o endereço aparece no autocomplete. Quem a caixa bloqueou continua bloqueado.
Com unsubscribe: true, destinatários que já cancelaram a inscrição desta caixa são recusados com RECIPIENT_UNSUBSCRIBED, e recipients lista quem são. Respostas nunca são bloqueadas.
Argumentos
send_atstringobrigatórioRFC 3339,
YYYY-MM-DDou epoch ms. No mínimo 1 minuto a partir de agora e até 1 ano.modestringopcionalnew(padrão),replyouforward.idstringopcionalA mensagem original, para
replyeforward.tostring | string[]opcionalDestinatário. Obrigatório em
neweforward. Emnewpode ser uma lista de até 30 (planos pagos).ccstring[]opcionalCópias visíveis.
bccstring[]opcionalCópias ocultas.
subjectstringopcionalObrigatório para
new. Reply e forward usam por padrão Re: / Fwd: original.htmlstringopcionalCorpo HTML. Ou
text, outemplate_id.template_idstringopcionalPreenche o corpo (e o assunto de um e-mail novo) a partir de um template.
followup_after_hoursnumberopcionalLembra você se ninguém responder em tantas horas após o envio.
scheduled_idstringopcionalReagendar: o e-mail agendado antigo é substituído.
attachmentsobject[]opcionalArquivos a anexar:
[{ file_name, content, content_type }],contentem base64. Até 20 arquivos e 25 MB no total. Todo arquivo é verificado; um arquivo perigoso falha comFILE_BLOCKED.compose_uidstringopcionalAnexos que você enviou antes com
upload_attachment.attachment_idsstring[]opcionalQuais dos anexos enviados usar. Sem ele, todos.
track_opensbooleanopcionalRastreia quando cada destinatário abre o e-mail (pixel invisível). Padrão
true.track_clicksbooleanopcionalRastreia cliques nos links (cada link passa por um redirecionamento). Padrão
true.unsubscribebooleanopcionalAdiciona um link de descadastro. Coloque
[unsubscribe]no corpo (nohrefde um link ou como texto) onde o link deve ficar; sem ele, uma linha padrão é adicionada no fim. Padrãofalse.audiencestringopcionalEnvia para um público em vez de endereços:
subscribed,opened,clicked,both,seg:<segment_id>oumsg:<message_uid>:opened|clicked|not_opened. Otofica opcional. Até 5.000 pessoas. O link de descadastro é ligado e o email sai como marketing. Planos pagos.best_timebooleanopcionalEnvia para cada pessoa no horário em que ela costuma abrir ou clicar, ao longo do dia de
send_at. Precisa deaudienceemode: new.send_até 00:00 desse dia no seu fuso, em UTC.best_fallback_atstring | numberopcionalHorário para quem não tem histórico (RFC 3339 ou epoch ms). Precisa ser no mesmo dia de
send_at.
Início rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "schedule_send",
args: {
to: "ana@client.com",
subject: "Proposal",
html: "<p>Hi Ana, here is the proposal.</p>",
send_at: "2026-10-27T09:00:00+08:00"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Resposta
{
"type": "SUCCESS",
"results": [
{
"command": "schedule_send",
"id": "0",
"type": "SUCCESS",
"data": {
"scheduled_id": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"send_at": "2026-10-27T01:00:00Z"
}
}
]
}Campos da resposta
scheduled_idA mensagem em Scheduled. Use-a para cancelar, reagendar ou enviar agora.
Listar o que está agendado
Os e-mails agendados ficam na pasta Scheduled, ordenados pela hora de envio.
Body da requisição
{
"commands": [
{
"command": "list_messages",
"args": {
"folder": "Scheduled"
}
}
]
}Erros
Erros no nível HTTP retornam type, code e message. Erros marcados com CMD voltam dentro do resultado do comando, com HTTP 200.
- 401
TOKEN_EXPIREDO access token expirou. Chame Refresh Token e repita a requisição.
- 401
INVALID_TOKENO token está malformado, é desconhecido ou foi revogado.
- 429
RATE_LIMITEDMais de 15 requisições/s ou 15 em andamento para o mesmo IP + caixa de correio. Espere o número de segundos indicado em Retry-After.
- CMD
INVALID_AUDIENCEO público não é válido: grupo desconhecido, segmento de outra caixa ou mensagem que esta caixa não enviou.
- CMD
AUDIENCE_OVER_LIMITO público tem mais pessoas do que você pode enviar (até 5.000 por email e o seu limite diário). `total` e `allowed` dizem quantas.
- CMD
EMPTY_AUDIENCENinguém neste público agora.
- CMD
BEST_TIME_NEEDS_AUDIENCE`best_time` precisa de um `audience` e `mode: new`.
- CMD
RECIPIENT_UNSUBSCRIBEDUm ou mais destinatários cancelaram a inscrição desta caixa. `recipients` lista quem são: remova-os ou envie de novo com `unsubscribe: false`.
- CMD
PAID_PLAN_REQUIREDMais de um endereço em `to` exige um plano pago.
- CMD
TOO_MANY_RECIPIENTS`to` tem mais de 30 endereços.
- CMD
INVALID_ARGSUm argumento obrigatório está ausente ou é inválido.
- CMD
INVALID_TIMEsend_at está ausente, a menos de 1 minuto ou a mais de 1 ano de distância.
- CMD
INVALID_RECIPIENTO destinatário está ausente ou não é um e-mail válido.
- CMD
MISSING_SUBJECTUm e-mail novo precisa de assunto.
- CMD
MISSING_TARGETReply e forward precisam do e-mail original, e ele ainda precisa existir.
- CMD
RECIPIENT_LIMIT_EXCEEDEDto, cc e bcc juntos têm mais de 50 endereços.
- CMD
FILE_BLOCKEDUm arquivo foi bloqueado pela verificação de segurança.
- CMD
ATTACHMENTS_TOO_LARGEOs anexos do e-mail somam mais de 25 MB, ou a caixa de correio já tem 500 MB de uploads aguardando envio.
- CMD
INTERNALErro no servidor. O detalhe só é gravado no log do servidor.