Email

Headers personalizados

Añade headers personalizados a tus emails salientes usando el objeto headers en la solicitud de envío.

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

Restricción de nombres:cualquier header fuera de la lista reservada de abajo debe empezar por X-. Se aplica para evitar la inyección de headers y proteger los campos reservados por RFC.

Headers reservados

Estos headers no necesitan el prefijo X-. Para los headers de baja, consultaHeaders de baja.

  • List-Id

    Identifica la lista de correo a la que pertenece el email.

  • X-Report-Abuse

    Una URL donde los destinatarios pueden denunciar abusos.

  • Feedback-ID

    Identificador que usan los proveedores de correo para agrupar los informes de feedback loop.

  • List-Unsubscribe

    Métodos de baja (mailto: y/o https:).

  • List-Unsubscribe-Post

    Activa la baja con un clic.

Cualquier otro header

Debe llevar el prefijo X-. Cualquier otro se rechaza antes de encolar el email.

Válido

  • "X-MyCustomHeader": "testcustom0"
  • "X-CUSTOM-X": "testcustom1"

No válido

  • "MyCustomHeader": "testcustom0"
  • → HEADER_NOT_ALLOWED

Inicio rápido

import axios from 'axios';

await axios.post(
  'https://mail.sendcorex.com/v3.0/send',
  {
    to: 'user@example.com',
    from: 'noreply@yourdomain.com',
    senderName: 'My App',
    subject: 'Welcome aboard!',
    body: '<h1>Welcome!</h1><p>Thanks for signing up.</p>',
    replyTo: 'support@yourdomain.com',
    headers: {
      'List-Id': 'My List <mylist.yourdomain.com>',
      'X-Report-Abuse': 'https://yourdomain.com/report-abuse',
      'Feedback-ID': 'campaign123:subscriber456:list789:youraccount',
      'List-Unsubscribe':
        '<mailto:unsubscribe@yourdomain.com?subject=unsubscribe>,<https://yourdomain.com/unsubscribe?u=123>',
      'List-Unsubscribe-Post': 'List-Unsubscribe=One-Click',
      'X-MyCustomHeader': 'testcustom0',
      'X-CUSTOM-X': 'testcustom1',
    },
  },
  { headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);

Respuesta

{
  "success": true,
  "message": "Email queued successfully",
  "code": "EMAIL_QUEUED_SUCCESS",
  "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"
}

Los errores devuelven un objeto JSON con error, code y responseTime.

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