Recibir correos: Programación
Programar envío
Escribe el correo ahora y envíalo más tarde. Espera en la carpeta Scheduled hasta la hora que elijas.
https://g.sendcorex.com/v1command: schedule_sendTodo lo que se puede comprobar se comprueba ahora (destinatario, asunto, correo original, adjuntos), para que te enteres antes de que llegue la hora. Los créditos y el límite diario se comprueban al enviar.
Si el envío se rechaza en ese momento (sin créditos, límite diario, spam), no se pierde nada: el correo vuelve a Borradores con el motivo.
Los destinatarios que rechazaron el seguimiento en la página de preferencias nunca se rastrean, incluso con true.
Los correos enviados desde el buzón no llevan la cabecera List-Unsubscribe ni enlace de baja, salvo que envíes unsubscribe: true, porque son correos personales.
Toda persona que recibe un correo del buzón pasa a ser un contacto de la lista “Webmail” de la cuenta y queda como trusted en este buzón: sus respuestas van a la Inbox y la dirección aparece en el autocompletado. Quien el buzón bloqueó sigue bloqueado.
Con unsubscribe: true, los destinatarios que ya se dieron de baja de este buzón se rechazan con RECIPIENT_UNSUBSCRIBED, y recipients los lista. Las respuestas nunca se bloquean.
Argumentos
send_atstringobligatorioRFC 3339,
YYYY-MM-DDo epoch ms. Al menos 1 minuto a partir de ahora y hasta 1 año.modestringopcionalnew(por defecto),replyoforward.idstringopcionalEl mensaje original, para
replyyforward.tostring | string[]opcionalDestinatario. Obligatorio en
newyforward. Ennewpuede ser una lista de hasta 30 (planes de pago).ccstring[]opcionalCopias visibles.
bccstring[]opcionalCopias ocultas.
subjectstringopcionalObligatorio para
new. Reply y forward usan por defecto Re: / Fwd: original.htmlstringopcionalCuerpo HTML. O
text, otemplate_id.template_idstringopcionalRellena el cuerpo (y el asunto de un correo nuevo) desde una plantilla.
followup_after_hoursnumberopcionalTe avisa si nadie responde tantas horas después del envío.
scheduled_idstringopcionalReprogramar: el correo programado anterior se reemplaza.
attachmentsobject[]opcionalArchivos para adjuntar:
[{ file_name, content, content_type }],contenten base64. Hasta 20 archivos y 25 MB en total. Se analiza cada archivo; uno peligroso falla conFILE_BLOCKED.compose_uidstringopcionalAdjuntos que subiste antes con
upload_attachment.attachment_idsstring[]opcionalCuáles de los adjuntos subidos enviar. Sin él, todos.
track_opensbooleanopcionalRegistra cuándo cada destinatario abre el correo (píxel invisible). Por defecto
true.track_clicksbooleanopcionalRegistra los clics en los enlaces (cada enlace pasa por una redirección). Por defecto
true.unsubscribebooleanopcionalAñade un enlace de baja. Pon
[unsubscribe]en el cuerpo (en elhrefde un enlace o como texto) donde debe ir el enlace; sin él, se añade una línea por defecto al final. Por defectofalse.audiencestringopcionalEnvía a un público en lugar de direcciones:
subscribed,opened,clicked,both,seg:<segment_id>omsg:<message_uid>:opened|clicked|not_opened.topasa a ser opcional. Hasta 5.000 personas. El enlace de baja se activa y el correo sale como marketing. Planes de pago.best_timebooleanopcionalEnvía a cada persona a la hora en que suele abrir o hacer clic, durante el día de
send_at. Necesitaaudienceymode: new.send_ates las 00:00 de ese día en tu zona horaria, en UTC.best_fallback_atstring | numberopcionalHora para quienes no tienen historial (RFC 3339 o epoch ms). Debe ser el mismo día que
send_at.
Inicio 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);Respuesta
{
"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 de la respuesta
scheduled_idEl mensaje en Scheduled. Úsalo para cancelar, reprogramar o enviar ahora.
Listar lo programado
Los correos programados están en la carpeta Scheduled, ordenados por hora de envío.
Body de la solicitud
{
"commands": [
{
"command": "list_messages",
"args": {
"folder": "Scheduled"
}
}
]
}Errores
Los errores a nivel HTTP devuelven type, code y message. Los errores marcados con CMD vuelven dentro del resultado del comando, con HTTP 200.
- 401
TOKEN_EXPIREDEl access token expiró. Llama a Refresh Token y repite la solicitud.
- 401
INVALID_TOKENEl token está mal formado, es desconocido o fue revocado.
- 429
RATE_LIMITEDMás de 15 solicitudes/s o 15 en curso para la misma IP + buzón. Espera la cantidad de segundos indicada en Retry-After.
- CMD
INVALID_AUDIENCEEl público no es válido: grupo desconocido, segmento de otro buzón o mensaje que este buzón no envió.
- CMD
AUDIENCE_OVER_LIMITEl público tiene más personas de las que puedes enviar (hasta 5.000 por correo y tu límite diario). `total` y `allowed` indican cuántas.
- CMD
EMPTY_AUDIENCENo hay nadie en este público ahora.
- CMD
BEST_TIME_NEEDS_AUDIENCE`best_time` necesita un `audience` y `mode: new`.
- CMD
RECIPIENT_UNSUBSCRIBEDUno o más destinatarios se dieron de baja de este buzón. `recipients` los lista: quítalos o envía de nuevo con `unsubscribe: false`.
- CMD
PAID_PLAN_REQUIREDMás de una dirección en `to` requiere un plan de pago.
- CMD
TOO_MANY_RECIPIENTS`to` tiene más de 30 direcciones.
- CMD
INVALID_ARGSFalta un argumento obligatorio o no es válido.
- CMD
INVALID_TIMEFalta send_at, faltan menos de 1 minuto o más de 1 año.
- CMD
INVALID_RECIPIENTFalta el destinatario o no es un correo válido.
- CMD
MISSING_SUBJECTUn correo nuevo necesita asunto.
- CMD
MISSING_TARGETReply y forward necesitan el correo original, y este todavía debe existir.
- CMD
RECIPIENT_LIMIT_EXCEEDEDto, cc y bcc juntos tienen más de 50 direcciones.
- CMD
FILE_BLOCKEDEl análisis de seguridad bloqueó un archivo.
- CMD
ATTACHMENTS_TOO_LARGELos adjuntos del correo suman más de 25 MB, o el buzón ya tiene 500 MB de archivos subidos esperando a enviarse.
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.