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.

POSThttps://g.sendcorex.com/v1command: list_messages

Argumentos

  • folderstringopcional

    Carpeta que se lista. Por defecto INBOX.

  • limitnumberopcional

    Tamaño de página, de 1 a 100. Por defecto 25.

  • cursorstringopcional

    El next_cursor de la página anterior.

  • is_readbooleanopcional

    Filtra por estado de lectura. Este filtro recorre la carpeta.

  • is_starredbooleanopcional

    Filtra por destacado. Este filtro recorre la carpeta.

  • is_importantbooleanopcional

    Filtra por importancia. Este filtro recorre la carpeta.

  • is_spambooleanopcional

    Filtra por spam. Este filtro recorre la carpeta.

  • afterstringopcional

    Solo mensajes recibidos en esta fecha o después. RFC 3339, YYYY-MM-DD (UTC) o epoch en milisegundos.

  • beforestringopcional

    Solo mensajes recibidos antes de esta fecha. Mismos formatos que after.

  • labelstringopcional

    Lista los mensajes con esta etiqueta en todas las carpetas. folder y los filtros booleanos se ignoran. No distingue mayúsculas de minúsculas. after y before siguen 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_uid

    El id del mensaje.

  • messages[].thread_id

    La conversación a la que pertenece el mensaje.

  • messages[].folder

    La carpeta de esta entrada.

  • messages[].subject / preview

    Asunto y una vista previa breve.

  • messages[].from_name / from_email

    El remitente.

  • messages[].has_attachments / size_bytes

    Flag de adjunto y tamaño del mensaje.

  • messages[].is_read / is_starred / is_important / is_spam

    Estado del mensaje.

  • messages[].snoozed_until

    Cuándo vence un mensaje pospuesto, o null.

  • messages[].received_at

    Cuándo se recibió el mensaje.

  • has_more / next_cursor

    Paginació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.

  • 401TOKEN_EXPIRED

    El access token expiró. Llama a Refresh Token y repite la solicitud.

  • 401INVALID_TOKEN

    El token está mal formado, es desconocido o fue revocado.

  • 429RATE_LIMITED

    Más de 15 solicitudes/s o 15 en curso para la misma IP + buzón. Espera la cantidad de segundos indicada en Retry-After.

  • CMDINVALID_ARGS

    Falta un argumento obligatorio o no es válido.

  • CMDINVALID_CURSOR

    El cursor está mal formado o pertenece a otra cuenta o carpeta.

  • CMDINTERNAL

    Error del servidor. El detalle solo se escribe en el log del servidor.