Recibir correos: Lectura
Listar hilos
Lista las conversaciones de una carpeta, al estilo de Gmail, con filtros de no leídos, destacados, importantes, adjuntos y fechas.
https://g.sendcorex.com/v1command: list_threadsCada elemento es una conversación. Ábrela con get_thread o get_messages usando su last_message_uid.
Argumentos
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_readbooleanopcionalfalsedevuelve solo conversaciones con algún mensaje no leído.is_starredbooleanopcionalFiltra por destacado.
is_importantbooleanopcionalFiltra por importancia.
has_attachmentsbooleanopcionalFiltra por adjuntos.
afterstringopcionalSolo conversaciones cuyo último mensaje es de esta fecha en adelante (inclusive). RFC 3339,
YYYY-MM-DD(UTC) o epoch en milisegundos.p. ej.
"2026-10-01"beforestringopcionalSolo conversaciones cuyo último mensaje es anterior a esta fecha (exclusive). Mismos formatos que
after.p. ej.
"2026-10-08T00:00:00+08:00"
Inicio rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "list_threads",
args: {
folder: "INBOX",
is_read: false,
limit: 20
}
}
]
},
{ 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_threads",
"id": "0",
"type": "SUCCESS",
"data": {
"threads": [
{
"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",
"participants": [
"ana@client.com",
"you@yourdomain.com"
],
"last_senders": [
"ana@client.com"
],
"message_count": 2,
"thread_message_count": 3,
"unread_count": 1,
"has_unread": true,
"has_starred": false,
"has_important": false,
"has_attachments": false,
"last_message_uid": "Vj0xQUJDMTIz",
"last_message_at": "2026-10-09T14:21:07Z"
}
],
"has_more": true,
"next_cursor": "eyJwIjoyfQ"
}
}
]
}Campos de la respuesta
threads[].thread_idEl id de la conversación.
threads[].folderLa carpeta que se lista.
threads[].subjectAsunto de la conversación.
threads[].previewVista previa breve del último mensaje.
threads[].from_name / from_emailRemitente del último mensaje.
threads[].participantsTodos los participantes de la conversación.
threads[].last_sendersQuién escribió los últimos mensajes.
threads[].message_countMensajes en esta carpeta.
threads[].thread_message_countMensajes en toda la conversación.
threads[].unread_count / has_unreadMensajes no leídos en la conversación.
threads[].has_starred / has_important / has_attachmentsFlags de la conversación.
threads[].last_message_uidEl id para abrir la conversación con
get_messagesoget_thread.threads[].last_message_atFecha del último mensaje.
has_more / next_cursorPaginación. Envía
next_cursorcomocursorpara obtener la página siguiente.
Filtros y velocidad
is_read: false, is_starred: true e is_important: true usan su propio índice, así que solo se examinan las conversaciones que coinciden, no toda la carpeta. Si los combinas, se usa un índice (destacado, luego importante, luego no leído) y el resto se filtra sobre él. after y before son rangos de claves, así que no se recorre nada fuera del periodo. has_attachments y los valores false de destacado e importante siguen recorriendo la carpeta.
Conversaciones no leídas en un rango de fechas
{
"commands": [
{
"command": "list_threads",
"args": {
"is_read": false,
"after": "2026-10-01",
"before": "2026-10-08T00:00:00+08:00"
}
}
]
}Paginación
Cuando has_more sea true, vuelve a llamar al comando con cursor igual a next_cursor.
Node.js
let cursor;
const threads = [];
do {
const [result] = await call({
command: 'list_threads',
args: { folder: 'INBOX', limit: 100, ...(cursor ? { cursor } : {}) },
});
threads.push(...result.data.threads);
cursor = result.data.has_more ? result.data.next_cursor : null;
} while (cursor);call es cualquier helper que hace POST de { commands: [...] } a /v1 y devuelve results, como en Run Commands.
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.