Autenticación
Envía una clave srs_live_ con scope emitida en el panel como token Bearer. Cada clave tiene sus propios scopes (emails:send, webhooks:write …); las claves revocadas o caducadas se rechazan con 401.
POST /v1/emails
Authorization: Bearer srs_live_...
Idempotency-Key: reset-4821
Content-Type: application/json
{
"from": "Sender Name <info@example.com>",
"to": ["user@example.net"],
"subject": "Reset your password",
"html": "<p>Click to reset your password.</p>"
}Recursos principales
- POST /v1/emails — pone en cola un mensaje
- POST /v1/emails/batch — hasta 100 mensajes en una solicitud
- GET /v1/emails — lista mensajes recientes
- GET /v1/emails/{id} — estado del mensaje
- DELETE /v1/emails/{id}/schedule — cancela un envío programado
Modelo de respuesta
202 significa en cola, no entregado en la bandeja de entrada. 403 puede indicar falta de scope o un dominio sin verificar. 422 bloquea a un destinatario suprimido. 429 indica limitación de tasa (rate limiting).
Límites actuales del servicio
La API REST rechaza adjuntos. Solo admite los encabezados personalizados In-Reply-To, References, List-Unsubscribe y List-Unsubscribe-Post (hasta 8). El correo alojado es independiente: la web admite hasta 20 adjuntos y 25 MiB en total; el cliente de escritorio publicado limita los envíos a 10 MiB. HTTP 202 y email.accepted significan aceptación para procesamiento; la aceptación SMTP no garantiza entrega ni llegada a la bandeja de entrada.