Recibir correos: Envío y confianza
Enviar correo
Envía un correo nuevo desde el remitente de tu token. El mensaje se guarda en Enviados al instante y se entrega en segundo plano.
https://g.sendcorex.com/v1command: send_emailqueued: true significa guardado y en espera en la cola, no entregado. El message_id de la respuesta es provisional: el Message-ID SMTP real lo reemplaza unos segundos después y aparece en get_messages.
Cada destinatario (to + cc + bcc) recibe su propia copia y usa 1 crédito. Las direcciones en bcc nunca aparecen en los headers. El cuerpo está limitado a 2 MB, y los adjuntos a 25 MB en total.
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
tostring | string[]obligatorioDirección del destinatario, o una lista de hasta 30 direcciones (planes de pago). Con
unsubscribe: truecada persona recibe su propia copia; sin él, todos entoyccse ven entre sí.to_namestringopcionalNombre del destinatario. Por defecto, la parte antes de la
@.subjectstringobligatorioAsunto del correo.
htmlstringopcionalCuerpo HTML. Envía
htmlotext.textstringopcionalCuerpo en texto plano. Se convierte a HTML con
<br>.ccstring[]opcionalCopias visibles. to + cc + bcc hasta 50 direcciones.
bccstring[]opcionalCopias ocultas. Nunca aparecen en los headers.
template_idstringopcionalRellena el cuerpo (y un asunto vacío) desde una plantilla. Los placeholders usan
to_nameyvariables.variablesobjectopcionalTus propios placeholders de plantilla:
{ "company": "Acme" }rellena{company}.attachmentsobject[]opcionalArchivos:
[{ file_name, content, content_type }],contenten base64. Hasta 20 archivos, 25 MB en total. Se analiza cada archivo.compose_uidstringopcionalAdjuntos subidos antes con
upload_attachment.attachment_idsstring[]opcionalQué adjuntos subidos enviar. Sin él, todos.
followup_atstringopcionalTe avisa si nadie responde antes de esta fecha (RFC 3339,
YYYY-MM-DDo epoch ms).labelstringopcionalUna etiqueta para poner en el mensaje enviado. Se convierte en
labels: [label].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.
Inicio rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "send_email",
args: {
to: "client@example.com",
to_name: "Client",
cc: [
"manager@example.com"
],
subject: "Quote",
html: "<p>Here is the quote.</p>",
attachments: [
{
file_name: "quote.pdf",
content: "JVBERi0xLjcKJcfsj6IK…",
content_type: "application/pdf"
}
],
followup_at: "2026-10-29T09:00:00+08:00",
label: "sales"
}
}
]
},
{ 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": "send_email",
"id": "0",
"type": "SUCCESS",
"data": {
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"message_id": "<5e0b9c1a-3d7f-4a21-9a6e-2f1c8d4b7e90>",
"recipients": 2,
"queued": true
}
}
]
}Campos de la respuesta
message_uidEl id del mensaje enviado. Aparece en
Sentde inmediato.thread_idLa conversación del nuevo mensaje.
message_idUn Message-ID provisional. El SMTP real lo reemplaza poco después.
recipientsCuántas copias se pusieron en cola (to + cc + bcc), 1 crédito cada una.
queuedtrue= guardado y en cola de entrega. No significa entregado.
Envíos repetidos
La misma escritura (mismos args) repetida dentro de 1,5 segundos devuelve el primer resultado en lugar de volver a enviar. Un bucle de polling que envía el mismo correo dos veces no lo duplica.
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
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_TOADDRESSLa dirección to no es un correo válido.
- CMD
INVALID_CCADDRESSUna de las direcciones cc no es un correo válido.
- CMD
INVALID_BCCADDRESSUna de las direcciones bcc no es un correo válido.
- CMD
RECIPIENT_LIMIT_EXCEEDEDto, cc y bcc juntos tienen más de 50 direcciones.
- CMD
INVALID_ATTACHMENTEl contenido de un adjunto no es base64 válido.
- 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
ATTACHMENT_MISSINGUn adjunto subido ya no existe (los archivos subidos que no se envían en 48 horas, y que no usa un borrador o correo programado, se eliminan). Vuelve a subirlo.
- CMD
NO_CREDITSLa cuenta tiene menos créditos de correo que destinatarios (1 crédito por copia).
- CMD
SENDER_NOT_FOUNDEl remitente del token no está registrado.
- CMD
SENDER_NO_DOMAINEl remitente del token no tiene dominio.
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.