Email

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.

POSThttps://mail.sendcorex.com/v3.0/send
i

Guarda el id devuelto. Lo necesitarás paracancelar el email antes de que se envíe.

Parámetro adicional

  • scheduled_atstringopcionalnuevo

    Cuá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
}

Los errores devuelven un objeto JSON con error y code.

  • 401MISSING_AUTH_HEADER

    No hay header Authorization.

  • 401INVALID_API_KEY

    La API key no es válida o fue revocada.

  • 401ACCOUNT_BLOCKED

    La cuenta fue bloqueada.

  • 401NO_CREDITS_LEFT

    No hay créditos de email suficientes para todos los destinatarios. Cada dirección en to, cc y bcc usa 1 crédito.

  • 401DOMAIN_NOT_VALIDATED

    Dominio del remitente no verificado.

  • 401LISTED_SPAM_HAUS

    El dominio del remitente está listado en Spamhaus.

  • 401ISP_DOMAIN_BLOCKED

    No se permite enviar desde dominios conocidos (gmail.com, outlook.com, etc).

  • 401FROM_HEADER_DOMAIN_MISMATCH

    Dominio del header From no autorizado para este remitente.

  • 401USER_NOT_FOUND

    Usuario no encontrado.

  • 401MISSING_USER_PRIVILEGES

    Faltan privilegios de usuario.

  • 401EMAIL_CREDITS_NOT_FOUND

    Error al obtener los créditos de email.

  • 401EMAIL_NOT_VALIDATED

    El email de la cuenta aún no fue verificado.

  • 429CREDENTIAL_TEMPORARILY_BLOCKED

    API key bloqueada temporalmente por violaciones repetidas de la política.

  • 429IP_TEMPORARILY_BLOCKED

    IP de la solicitud bloqueada temporalmente por violaciones repetidas de la política.

  • 429TOO_MANY_CONCURRENT_CONNECTIONS

    Demasiadas solicitudes simultáneas desde esta IP. Inténtalo de nuevo en breve.

  • 400INVALID_JSON

    El cuerpo de la solicitud no es un JSON válido.

  • 400MISSING_FROM

    El campo from falta o está vacío.

  • 400INVALID_FROM_FORMAT

    El campo from debe ser una dirección de email válida.

  • 400MISSING_SENDERNAME

    El campo senderName falta o está vacío.

  • 400INVALID_SENDERNAME_FORMAT

    El campo senderName contiene caracteres no válidos.

  • 400MISSING_SUBJECT

    El campo subject falta o está vacío.

  • 400MISSING_BODY

    El campo body falta o está vacío.

  • 400MISSING_TOADDRESS

    El campo to falta o está vacío.

  • 400MISSING_TO

    El campo to falta o está vacío.

  • 400INVALID_TOADDRESS

    Una o más direcciones de destinatario están mal formadas.

  • 400TOADDRESS_LIMIT_EXCEEDED

    Más de 50 destinatarios en el array to.

  • 400INVALID_CCADDRESS

    Una o más direcciones de cc están mal formadas.

  • 400INVALID_BCCADDRESS

    Una o más direcciones de bcc están mal formadas.

  • 400RECIPIENT_LIMIT_EXCEEDED

    to, cc y bcc juntos tienen más de 50 destinatarios únicos.

  • 400INVALID_SCHEDULED_AT

    scheduled_at no es una fecha válida o está en el pasado.

  • 400INVALID_SENDER_FORMAT

    El formato del email del remitente no es válido.

  • 400HEADER_NOT_ALLOWED

    La clave del header personalizado no está en la lista permitida (List-Unsubscribe, List-Id, X-*, etc).

  • 400INVALID_HEADER_VALUE

    El valor del header contiene caracteres no válidos (CR/LF no permitidos).

  • 400DANGEROUS_ATTACHMENT

    Uno o más adjuntos fueron bloqueados por motivos de seguridad.

  • 400INVALID_ATTACHMENT

    El contenido de un adjunto no es base64 válido.

  • 400MISSING_UNSUBSCRIBE_PLACEHOLDER

    unsubscribe es true pero el body no tiene placeholder de baja ([unsubscribe_url], [unsubscribe], [unsub_url] o [opt_out_url]).

  • 403ACCOUNT_RESTRICTED

    La cuenta está restringida temporalmente.

  • 403DAILY_LIMIT

    Se alcanzó el límite diario de envío de emails.

  • 403MARKETING_LIMIT_REACHED

    Se 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.

  • 403FORBIDDEN_HTML_CONTENT

    El 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.

  • 403SPAM_DETECTED

    Contenido del email marcado como spam. La respuesta incluye el quarantine_id y las instrucciones de liberación.

  • 403SENDER_NAME_MISMATCH

    Se detectaron varios nombres de remitente para la misma dirección.

  • 403FOLLOWUP_PATTERN_DETECTED

    Contenido del email marcado como patrón repetido de seguimiento sospechoso.

  • 403SCAM_PATTERN_DETECTED

    Contenido del email marcado como patrón de estafa.

  • 403ACCOUNT_SUSPENDED_SPOOFING

    Cuenta suspendida por intentos repetidos de suplantación del header From.

  • 409IDEMPOTENCY_IN_PROGRESS

    Una solicitud con la misma Idempotency-Key todavía se está procesando. Espera (Retry-After: 1) y reintenta con la misma clave.

  • 422IDEMPOTENCY_KEY_REUSED

    Esta Idempotency-Key ya se usó con otro cuerpo. Usa una clave nueva para cada email nuevo.

  • 500INTERNAL_SERVER_ERROR

    Error inesperado del servidor. Inténtalo de nuevo.

  • 500PARSE_ERROR

    No se pudo procesar el contenido del email (fallo de parse MIME).

  • 500PERSIST_FAILED

    No se pudo poner el email en cola (fallo de persistencia en la base de datos).

  • 503AUTH_UNAVAILABLE

    No se pudo validar la API key en este momento. Inténtalo de nuevo.

  • 503UNSUBSCRIBE_UNAVAILABLE

    Servicio de enlace de baja no disponible temporalmente. Inténtalo más tarde.