Email API

Envío de emails transaccionales (restablecimiento de contraseña, avisos, confirmaciones) a través de Sendeasy, desde tu propia aplicación, autenticado por el token del propio email — cada email configurado en el proyecto tiene el suyo.

El envío sale por el email dueño del token y consume 1 crédito de email del proyecto. No informas el remitente: es el email del token. ¿Tienes más de un email? Usa el token de aquel por el que quieras enviar.

Requisitos previos

1. Token del email — en Canales → Email (o en la tarjeta del email en Canales) → Configuración → sección API de envío. Cada email tiene su propio token; allí también puedes generar uno nuevo (el anterior deja de valer de inmediato).
2. El email con estado Verificado (mismo lugar). Sin esto la ruta responde 503 ERR_EMAIL_SENDER_NOT_CONFIGURED y no sale nada, aunque haya crédito.
3. Créditos de email disponibles en el plan del proyecto.

Usa GET /api/v1/email/health para comprobar los puntos 1 y 2 sin gastar crédito.

Autenticación

Header obligatorio, con el token del email remitente:

Authorization: Bearer <token_del_email>

El token identifica el email remitente y, a través de él, el proyecto — no hay whatsappId/emailId en la URL.

Endpoints

Límite: 20 solicitudes por minuto por origen (429 ERR_PUBLIC_EMAIL_RATE_LIMIT).

Envío de email

POST /api/v1/email/send

Payload

Ejemplo

curl --location 'https://server.sendeasy.pro/api/v1/email/send' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer TOKEN_DEL_EMAIL' \
  --data '{
    "to": "cliente@ejemplo.com",
    "subject": "Restablecimiento de contraseña",
    "fromName": "Mi Plataforma",
    "html": "<p>¡Hola! Haz clic en el enlace de abajo para crear una nueva contraseña.</p>"
  }'

Respuesta de éxito:

{
  "success": true,
  "id": "9fbbb3a9-4c1e-4b1a-9d1e-0c2b7e3f5a61"
}

El id es el identificador del envío en el proveedor. La respuesta confirma que el email fue aceptado para entrega — la entrega final depende del servidor del destinatario.

Diagnóstico de la integración

GET /api/v1/email/health

No consume crédito. Indica si el email del token ya está verificado — la causa más común de que un envío falle aun con crédito disponible.

curl --location 'https://server.sendeasy.pro/api/v1/email/health' \
  --header 'Authorization: Bearer TOKEN_DEL_EMAIL'

{
  "ok": true,
  "senderConfigured": true,
  "sender": "no-reply@tuempresa.com",
  "domain": "tuempresa.com",
  "channelId": 12
}

Con senderConfigured: false, termina de verificar el email en Canales → Email antes de enviar. (Con el API Token del proyecto la respuesta viene sin channelId y dice si el proyecto tiene algún email verificado.)

Créditos y reembolso

• Cada envío aceptado descuenta 1 crédito de email del proyecto.
• Sin crédito, la ruta responde 402 ERR_NO_EMAIL_CREDITS antes de cualquier débito.
• Si el envío falla después del débito (remitente no configurado, proveedor no disponible), el crédito se reembolsa automáticamente y la ruta responde 502/503.

Códigos de error

Email API vs. integración Custom

Sendeasy ofrece dos formas de enviar email por API — elige según el tipo de token que tengas:

Detalles de la integración Custom en /es/server/integracoes.