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

# Inicio rápido

> Envía tu primer email transaccional en menos de 5 minutos.

## Requisitos

* Tu `X-API-Key` (la recibiste de tu administrador de plataforma)
* Una plantilla de email creada en el dashboard (`/app/me`)
* `curl` o cualquier cliente HTTP

## 1. Verifica tu acceso

```bash theme={null}
curl https://api.axelo.mx/health
```

Respuesta esperada:

```json theme={null}
{"status": "ok"}
```

## 2. Envía un email

```bash theme={null}
curl -X POST https://api.axelo.mx/v1/send/email \
  -H "Content-Type: application/json" \
  -H "X-API-Key: TU_API_KEY" \
  -d '{
    "to_address": "cliente@ejemplo.com",
    "to_name": "Juan Pérez",
    "template_id": "bienvenida",
    "data": {
      "nombre": "Juan",
      "empresa": "Mi Empresa"
    }
  }'
```

Respuesta:

```json theme={null}
{
  "job_id": "a1b2c3d4-...",
  "status": "pending"
}
```

## 3. Consulta el resultado

```bash theme={null}
curl https://api.axelo.mx/v1/jobs/a1b2c3d4-... \
  -H "X-API-Key: TU_API_KEY"
```

Cuando el email se entregó:

```json theme={null}
{
  "job_id": "a1b2c3d4-...",
  "status": "success",
  "result": {}
}
```

Si falló:

```json theme={null}
{
  "job_id": "a1b2c3d4-...",
  "status": "failed",
  "result": { "error": "connection refused" }
}
```

<Note>
  Los jobs fallidos se pueden reintentar desde el dashboard en **Mis reportes → Eventos**.
</Note>

## Siguientes pasos

<CardGroup cols={2}>
  <Card title="Variables en templates" icon="brackets-curly" href="/guides/variables">
    Personaliza cada email con datos dinámicos.
  </Card>

  <Card title="WhatsApp" icon="whatsapp" href="/guides/whatsapp">
    Envía mensajes de WhatsApp con la misma API.
  </Card>

  <Card title="Jobs asíncronos" icon="circle-notch" href="/guides/jobs">
    Entiende el ciclo de vida de un job.
  </Card>

  <Card title="Billing" icon="coins" href="/guides/billing">
    Cómo funciona el consumo de créditos.
  </Card>
</CardGroup>