Skip to main content

​
Endpoint

POST /v1/send/email

​
Headers

HeaderValor
X-API-KeyTu API key
Content-Typeapplication/json

​
Body

{
  "to_address":  "usuario@ejemplo.com",
  "to_name":     "Nombre Apellido",
  "subject":     "Asunto opcional con {{.variable}}",
  "template_id": "nombre-de-plantilla",
  "data": {
    "variable": "valor",
    "otra":     "valor2"
  }
}

​
Campos

CampoTipoRequeridoDescripción
to_addressstring✅Dirección de email destino
to_namestring—Nombre del destinatario (aparece en el “Para:“)
subjectstring—Asunto del email. Soporta variables {{.var}}. Si se omite, usa el subject de la plantilla
template_idstring✅ID de la plantilla HTML registrada en el dashboard
dataobject—Mapa de variables para inyectar en la plantilla y el subject

​
Ejemplo

curl -X POST https://comms.panzo.mx/v1/send/email \
  -H "Content-Type: application/json" \
  -H "X-API-Key: TU_API_KEY" \
  -d '{
    "to_address":  "cliente@ejemplo.com",
    "to_name":     "Ana López",
    "subject":     "Tu pedido {{.numero}} está en camino",
    "template_id": "pedido-enviado",
    "data": {
      "numero":   "ORD-7834",
      "fecha":    "28 de marzo de 2026",
      "tracking": "MX123456789"
    }
  }'

​
Respuesta 202

{
  "job_id": "c3d4e5f6-a1b2-...",
  "status": "pending"
}
Usa el job_id para consultar el resultado con GET /v1/jobs/.

​
Errores

CódigoCausa
400template_id vacío o body malformado
401API key inválida
403Canal email no habilitado para tu tenant
500Error al encolar el job