Email

Enviar adjuntos

Adjunta archivos a cualquier email incluyendo el array attachments en el payload de envío. Los archivos deben estar codificados en base64 y puedes incluir varios adjuntos en una sola llamada.

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

Los adjuntos usan el mismo endpoint que Enviar email. Añade el array attachments junto a los demás parámetros del body.

Parámetros del adjunto

Cada elemento del array attachments es un objeto con los campos siguientes.

  • filenamestringobligatorio

    El nombre de archivo que ve el destinatario en su cliente de email.

    p. ej. "invoice.pdf"

  • contentstringobligatorio

    El contenido del archivo codificado como string base64.

    p. ej. "JVBERi0xLjQKJeLjz9MK..."

  • encodingstringobligatorio

    La codificación de content. Debe ser "base64".

    p. ej. "base64"

Inicio rápido

import axios from 'axios';
import fs from 'fs';

const fileContent = fs.readFileSync('./invoice.pdf').toString('base64');

try {
  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 Invoice #1042',
      body: '<p>Please find your invoice attached.</p>',
      attachments: [
        {
          filename: 'invoice.pdf',
          content: fileContent,
          encoding: 'base64',
        },
      ],
    },
    { headers: { Authorization: process.env.SENDCOREX_API_KEY } }
  );

  const { id, ids, recipients } = response.data;
  console.log('Queued:', id, '| recipients:', recipients);
} catch (err) {
  if (err.response?.status === 400 && err.response.data.code === 'DANGEROUS_ATTACHMENT') {
    // Attachment blocked for security reasons. There is no quarantine record.
    console.log('Blocked:', err.response.data.riskLevel);
  } else {
    throw err;
  }
}

Respuesta

{
  "success": true,
  "message": "Email queued successfully",
  "code": "EMAIL_QUEUED_SUCCESS",
  "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "ids": [
    { "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f", "recipient": "user@example.com" }
  ],
  "recipients": 1,
  "scheduledAt": null
}

Mi adjunto fue bloqueado

Para proteger nuestra plataforma y la reputación de envío de todos los clientes, los adjuntos se revisan antes de encolar un email. Cuando un archivo se considera inseguro, la solicitud devuelve 400 con el código DANGEROUS_ATTACHMENT y el email no se envía.

400

Adjunto bloqueado

{
  "error": "One or more attachments were blocked for security reasons.",
  "code": "DANGEROUS_ATTACHMENT",
  "riskLevel": "high"
}
  • error

    Un mensaje legible que explica que se bloqueó un adjunto.

  • code

    Siempre DANGEROUS_ATTACHMENT en esta respuesta.

  • riskLevel

    El nivel de riesgo asignado al adjunto bloqueado. Inclúyelo al contactar con soporte.

!

No hay registro de cuarentena para este error.A diferencia de los emails marcados como spam, un adjunto bloqueado no se puede liberar con /quarantine/release. Es una protección deliberada contra spammers y remitentes abusivos, por lo que el email nunca queda retenido para entregarse más tarde.

¿Qué debo hacer?

Las comprobaciones automáticas pueden marcar ocasionalmente un archivo legítimo. Si necesitas enviar este adjunto, contacta con nuestro equipo de soporte. Nuestro equipo conoce este comportamiento y, cuando un bloqueo resulta ser un falso positivo, lo revisamos y aplicamos las actualizaciones necesarias.

Para ayudarnos a resolverlo más rápido, incluye:

  • El nombre y el tipo de archivo del adjunto
  • El riskLevel devuelto por la API
  • Para qué se usa el archivo en tu producto
Contactar con soporte →

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.