Send Email - Shimli

POST /v1/email/send Envía un solo correo transaccional usando una plantilla guardada y un remitente verificado de la cuenta.

Body

{
  "token": "{{token}}",
  "sender": "snd_1a2b3c",
  "to": "cliente@empresa.com",
  "subject": "Confirmación de pedido",
  "templateId": "tpl_4d5e6f",
  "params": {
    "nombre": "María",
    "pedido": "A1024"
  },
  "reference": "orden-A1024"
}

También puedes pasar el remitente como objeto con email y name, siempre que esté registrado como sender en Shimli:

{
  "token": "{{token}}",
  "sender": {
    "email": "no-reply@empresa.com",
    "name": "Empresa"
  },
  "to": "cliente@empresa.com",
  "subject": "Confirmación de pedido",
  "templateId": "tpl_4d5e6f",
  "params": {
    "nombre": "María",
    "pedido": "A1024"
  },
  "reference": "orden-A1024"
}

Parámetros

Campo	Requerido	Qué hace
`token`	Sí	Token de autenticación
`sender`	Sí	ID del sender registrado en Shimli, u objeto con `email` y `name` de un sender registrado
`to`	Sí	Destinatario
`subject`	No	Asunto del correo; puede sobrescribir el de la plantilla
`templateId`	Sí	ID de la plantilla guardada de email
`params`	No	Variables para reemplazar dentro de la plantilla
`reference`	No	Referencia para idempotencia

Autenticación

Este endpoint requiere tu token de API. Inclúyelo en el body como token o como query param token / api-token. Ve Autenticación para más detalles.

Ejemplo de request

curl -X POST https://api.shimli.app/v1/email/send \
  -H "Content-Type: application/json" \
  -d '{
    "token": "{{token}}",
    "sender": "snd_1a2b3c",
    "to": "cliente@empresa.com",
    "subject": "Confirmación de pedido",
    "templateId": "tpl_4d5e6f",
    "params": {
      "nombre": "María",
      "pedido": "A1024"
    },
    "reference": "orden-A1024"
  }'

Respuesta

200 OK

{
  "statusCode": 200,
  "body": {
    "err": false,
    "msgId": "email_12345"
  }
}