> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shimli.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Send Email

> Endpoint POST /v1/email/send para envío transaccional de correo

`POST` `/v1/email/send`

Envía **un solo correo transaccional** usando una plantilla guardada y un remitente verificado de la cuenta.

## Body

```json theme={null}
{
  "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:

```json theme={null}
{
  "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](/getting-started/authentication) para más detalles.

## Ejemplo de request

```bash theme={null}
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

```json title="200 OK" theme={null}
{
  "statusCode": 200,
  "body": {
    "err": false,
    "msgId": "email_12345"
  }
}
```