Emails programados

POST/GET/DELETE /scheduled-emails — envios transaccionales diferidos.

Programa un email transaccional para envio futuro. La cuota se verifica en el momento del envio, no al programar.

Endpoints

Metodo	Ruta	Scope	Descripcion
`POST`	`/scheduled-emails`	`email:send`	Programar envio
`GET`	`/scheduled-emails`	`email:read`	Listar programados
`DELETE`	`/scheduled-emails/:id`	`email:send`	Cancelar pendiente

JWT del dashboard omite comprobacion de scopes.

POST /scheduled-emails

Mismo cuerpo que POST /emails/send mas:

Campo	Requerido	Descripcion
`sendAt`	Si	Fecha/hora ISO 8601 del envio
`timezone`	No	Zona IANA — default `Europe/Madrid`

{
  "to": "[email protected]",
  "subject": "Recordatorio de cita",
  "htmlBody": "<p>Tu cita es manana a las 10:00.</p>",
  "sendAt": "2026-06-20T10:00:00.000Z",
  "timezone": "Europe/Madrid"
}

Respuesta 201: id, status: "PENDING", sendAt, timezone, payload.

GET /scheduled-emails

?page=1&limit=20&status=PENDING — estados: PENDING | SENT | FAILED | CANCELLED.

DELETE /scheduled-emails/:id

Solo cancela filas en PENDING y elimina el job BullMQ (mc:scheduled-emails).