Programar email
Usa el mismo endpoint de envío con el parámetro scheduled_at para retrasar la entrega. Acepta fechas ISO 8601 o lenguaje natural. El email se puede cancelar hasta que se envía.
https://mail.sendcorex.com/v3.0/sendGuarda el id devuelto. Lo necesitarás paracancelar el email antes de que se envíe.
Parámetro adicional
scheduled_atstringopcionalnuevoCuándo enviar el email. Acepta formato ISO 8601 o lenguaje natural. Debe ser en el futuro.
p. ej.
"in 1 hour" · "tomorrow at 9am" · "2026-08-05T11:52:01Z"
Todos los demás parámetros son idénticos a los de Enviar email.
Lenguaje natural
Cualquiera de estos formatos funciona en scheduled_at.
"in 1 hour""in 30 minutes""tomorrow at 9am""Friday at 3pm ET""next Monday at 8am""2026-08-05T11:52:01Z"
Inicio rápido
import axios from 'axios';
const response = await axios.post(
'https://mail.sendcorex.com/v3.0/send',
{
to: 'user@example.com',
from: 'noreply@yourdomain.com',
senderName: 'My App',
subject: 'Your weekly digest',
body: '<p>Here is what happened this week...</p>',
scheduled_at: 'tomorrow at 9am',
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);
// Save the id: you need it to cancel the email before it is sent
const { id, ids, scheduledAt, recipients } = response.data;
console.log('Scheduled for ' + scheduledAt + ' (id: ' + id + ')');Respuesta
{
"success": true,
"message": "Email scheduled successfully",
"code": "EMAIL_SCHEDULED_SUCCESS",
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"ids": [
{ "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f", "recipient": "user@example.com" }
],
"scheduledAt": "2026-04-26T09:00:00.000Z",
"recipients": 1
}Errores
Todos los códigos de error →Los errores devuelven un objeto JSON con error y code.
- 401
MISSING_AUTH_HEADERNo hay header Authorization.
- 401
INVALID_API_KEYLa API key no es válida o fue revocada.
- 401
ACCOUNT_BLOCKEDLa cuenta fue bloqueada.
- 401
NO_CREDITS_LEFTNo hay créditos de email suficientes para todos los destinatarios. Cada dirección en to, cc y bcc usa 1 crédito.
- 401
DOMAIN_NOT_VALIDATEDDominio del remitente no verificado.
- 401
LISTED_SPAM_HAUSEl dominio del remitente está listado en Spamhaus.
- 401
ISP_DOMAIN_BLOCKEDNo se permite enviar desde dominios conocidos (gmail.com, outlook.com, etc).
- 401
FROM_HEADER_DOMAIN_MISMATCHDominio del header From no autorizado para este remitente.
- 401
USER_NOT_FOUNDUsuario no encontrado.
- 401
MISSING_USER_PRIVILEGESFaltan privilegios de usuario.
- 401
EMAIL_CREDITS_NOT_FOUNDError al obtener los créditos de email.
- 401
EMAIL_NOT_VALIDATEDEl email de la cuenta aún no fue verificado.
- 429
CREDENTIAL_TEMPORARILY_BLOCKEDAPI key bloqueada temporalmente por violaciones repetidas de la política.
- 429
IP_TEMPORARILY_BLOCKEDIP de la solicitud bloqueada temporalmente por violaciones repetidas de la política.
- 429
TOO_MANY_CONCURRENT_CONNECTIONSDemasiadas solicitudes simultáneas desde esta IP. Inténtalo de nuevo en breve.
- 400
INVALID_JSONEl cuerpo de la solicitud no es un JSON válido.
- 400
MISSING_FROMEl campo from falta o está vacío.
- 400
INVALID_FROM_FORMATEl campo from debe ser una dirección de email válida.
- 400
MISSING_SENDERNAMEEl campo senderName falta o está vacío.
- 400
INVALID_SENDERNAME_FORMATEl campo senderName contiene caracteres no válidos.
- 400
MISSING_SUBJECTEl campo subject falta o está vacío.
- 400
MISSING_BODYEl campo body falta o está vacío.
- 400
MISSING_TOADDRESSEl campo to falta o está vacío.
- 400
MISSING_TOEl campo to falta o está vacío.
- 400
INVALID_TOADDRESSUna o más direcciones de destinatario están mal formadas.
- 400
TOADDRESS_LIMIT_EXCEEDEDMás de 50 destinatarios en el array to.
- 400
INVALID_CCADDRESSUna o más direcciones de cc están mal formadas.
- 400
INVALID_BCCADDRESSUna o más direcciones de bcc están mal formadas.
- 400
RECIPIENT_LIMIT_EXCEEDEDto, cc y bcc juntos tienen más de 50 destinatarios únicos.
- 400
INVALID_SCHEDULED_ATscheduled_at no es una fecha válida o está en el pasado.
- 400
INVALID_SENDER_FORMATEl formato del email del remitente no es válido.
- 400
HEADER_NOT_ALLOWEDLa clave del header personalizado no está en la lista permitida (List-Unsubscribe, List-Id, X-*, etc).
- 400
INVALID_HEADER_VALUEEl valor del header contiene caracteres no válidos (CR/LF no permitidos).
- 400
DANGEROUS_ATTACHMENTUno o más adjuntos fueron bloqueados por motivos de seguridad.
- 400
INVALID_ATTACHMENTEl contenido de un adjunto no es base64 válido.
- 400
MISSING_UNSUBSCRIBE_PLACEHOLDERunsubscribe es true pero el body no tiene placeholder de baja ([unsubscribe_url], [unsubscribe], [unsub_url] o [opt_out_url]).
- 403
ACCOUNT_RESTRICTEDLa cuenta está restringida temporalmente.
- 403
DAILY_LIMITSe alcanzó el límite diario de envío de emails.
- 403
MARKETING_LIMIT_REACHEDSe alcanzó el límite diario de marketing del plan gratuito: 30 emails de marketing o cold outreach por día, contados por destinatario en una ventana móvil de 24 horas. La respuesta incluye limit, used, recipients y upgradeUrl. Los emails transaccionales se siguen enviando; nada queda en cola.
- 403
FORBIDDEN_HTML_CONTENTEl HTML contiene contenido activo no permitido en emails (script, iframe, form, input, button, embed, object, svg, handlers on*, enlaces javascript:, meta refresh…). La respuesta lista lo encontrado. Usa un <a> con estilos en lugar de botones o formularios.
- 403
SPAM_DETECTEDContenido del email marcado como spam. La respuesta incluye el quarantine_id y las instrucciones de liberación.
- 403
SENDER_NAME_MISMATCHSe detectaron varios nombres de remitente para la misma dirección.
- 403
FOLLOWUP_PATTERN_DETECTEDContenido del email marcado como patrón repetido de seguimiento sospechoso.
- 403
SCAM_PATTERN_DETECTEDContenido del email marcado como patrón de estafa.
- 403
ACCOUNT_SUSPENDED_SPOOFINGCuenta suspendida por intentos repetidos de suplantación del header From.
- 409
IDEMPOTENCY_IN_PROGRESSUna solicitud con la misma Idempotency-Key todavía se está procesando. Espera (Retry-After: 1) y reintenta con la misma clave.
- 422
IDEMPOTENCY_KEY_REUSEDEsta Idempotency-Key ya se usó con otro cuerpo. Usa una clave nueva para cada email nuevo.
- 500
INTERNAL_SERVER_ERRORError inesperado del servidor. Inténtalo de nuevo.
- 500
PARSE_ERRORNo se pudo procesar el contenido del email (fallo de parse MIME).
- 500
PERSIST_FAILEDNo se pudo poner el email en cola (fallo de persistencia en la base de datos).
- 503
AUTH_UNAVAILABLENo se pudo validar la API key en este momento. Inténtalo de nuevo.
- 503
UNSUBSCRIBE_UNAVAILABLEServicio de enlace de baja no disponible temporalmente. Inténtalo más tarde.