Próximos pasos

GET /api/v1/series/upcoming Lista los pasos de tus series activas que aún no han salido, del más próximo al más lejano, en todas las series a la vez. Es la lectura que la API no podía hacer: una serie publicada era visible, y nada decía cuándo saldrían sus pasos. Los momentos se calculan —fecha de inicio, esperas acumuladas a lo largo del recorrido y luego la hora de envío del paso— con la misma función que usan el editor, el calendario y el motor. Este endpoint no puede anunciar una hora que el envío no vaya a respetar.

Autorización

RolAcceso
OWNERPermitido
ADMINPermitido
MEMBERPermitido

Ejemplo

bash
curl -s 'https://www.agentsmail.io/api/v1/series/upcoming' \
  -H "x-api-key: $AGENTMAIL_API_KEY"

Respuesta

CódigoCuándo
200Los pasos por venir, posiblemente una lista vacía
401Clave ausente o no válida

Campos de la respuesta

CampoTipoDescripción
successbooleanSiempre true aquí
dataarrayLos pasos aún por venir, del más próximo al más lejano
data[].idstringCon el prefijo series:, nunca un id de campaña
data[].namestringEl nombre que llevará la campaña: <series name> · step N
data[].dueAtstringCuándo sale el paso, ISO 8601
data[].campaignIdnullSiempre null: la campaña todavía no existe

Ejemplo de respuesta

json
{
  "success": true,
  "data": [
    {
      "id": "series:3c3c3c3c-9999-4ddd-8eee-ffff11112222",
      "name": "March launch · step 2",
      "dueAt": "2026-03-18T08:00:00.000Z",
      "campaignId": null
    }
  ]
}

Notas

Nada de esto existe todavía como campaña, por eso campaignId es null y el id lleva prefijo. La campaña se crea en dueAt, con exactamente el nombre que indica name, y a partir de ahí se lee a través de la API de campañas como cualquier otra. Crear campañas por adelantado es imposible a propósito: un borrador en la lista podría enviarse a mano, fuera del orden de la serie. Un paso cuyo momento ya pasó no aparece: ya tiene su campaña.

Relacionado