Recibir correos: Lectura
Listar mensajes
Lista los mensajes uno por uno, sin agruparlos en conversaciones. También puedes listar todos los mensajes que tienen una etiqueta.
https://g.sendcorex.com/v1command: list_messagesArgumentos
folderstringopcionalCarpeta que se lista. Por defecto
INBOX.limitnumberopcionalTamaño de página, de 1 a 100. Por defecto 25.
cursorstringopcionalEl
next_cursorde la página anterior.is_readbooleanopcionalFiltra por estado de lectura. Este filtro recorre la carpeta.
is_starredbooleanopcionalFiltra por destacado. Este filtro recorre la carpeta.
is_importantbooleanopcionalFiltra por importancia. Este filtro recorre la carpeta.
is_spambooleanopcionalFiltra por spam. Este filtro recorre la carpeta.
afterstringopcionalSolo mensajes recibidos en esta fecha o después. RFC 3339,
YYYY-MM-DD(UTC) o epoch en milisegundos.beforestringopcionalSolo mensajes recibidos antes de esta fecha. Mismos formatos que
after.labelstringopcionalLista los mensajes con esta etiqueta en todas las carpetas.
foldery los filtros booleanos se ignoran. No distingue mayúsculas de minúsculas.afterybeforesiguen funcionando.p. ej.
"cliente-vip"
Inicio rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "list_messages",
args: {
folder: "INBOX",
is_read: false,
limit: 50
}
}
]
},
{ 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": "list_messages",
"id": "0",
"type": "SUCCESS",
"data": {
"messages": [
{
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"folder": "INBOX",
"subject": "Invoice for September",
"preview": "Hi, attached is the invoice for September…",
"from_name": "Ana Costa",
"from_email": "ana@client.com",
"has_attachments": false,
"size_bytes": 4821,
"is_read": false,
"is_starred": false,
"is_important": false,
"is_spam": false,
"snoozed_until": null,
"received_at": "2026-10-09T14:21:07Z"
}
],
"has_more": false,
"next_cursor": null
}
}
]
}Campos de la respuesta
messages[].message_uidEl id del mensaje.
messages[].thread_idLa conversación a la que pertenece el mensaje.
messages[].folderLa carpeta de esta entrada.
messages[].subject / previewAsunto y una vista previa breve.
messages[].from_name / from_emailEl remitente.
messages[].has_attachments / size_bytesFlag de adjunto y tamaño del mensaje.
messages[].is_read / is_starred / is_important / is_spamEstado del mensaje.
messages[].snoozed_untilCuándo vence un mensaje pospuesto, o
null.messages[].received_atCuándo se recibió el mensaje.
has_more / next_cursorPaginación.
Listar por etiqueta
Con label, el comando lee el índice de etiquetas, así que solo se examinan los mensajes etiquetados. Cada mensaje se devuelve con su estado actual en todas las carpetas, así que recibes folders y labels en lugar de un único folder.
Datos de respuesta con etiqueta
{
"messages": [
{
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"subject": "Invoice for September",
"preview": "Hi, attached is the invoice for September…",
"from_name": "Ana Costa",
"from_email": "ana@client.com",
"folders": [
"INBOX"
],
"labels": [
"cliente-vip"
],
"is_read": false,
"is_starred": false,
"is_important": false,
"received_at": "2026-10-09T14:21:07Z"
}
],
"has_more": false,
"next_cursor": null
}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_ARGSFalta un argumento obligatorio o no es válido.
- CMD
INVALID_CURSOREl cursor está mal formado o pertenece a otra cuenta o carpeta.
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.