Quickstart

Esta guía te lleva de cero a tu primer email enviado en menos de 5 minutos. Vamos a usar la Test key — envía emails reales pero no consume tu cuota mensual ni contamina tus métricas.

Si todavía no tenés cuenta, registrate en app.reallyquickemails.com. Necesitás un dominio verificado para enviar; ver guía de dominios.

Obtener tu Test API Key

Ingresa al dashboard.
Selecciona tu proyecto.
Ve a Configuración → Integraciones → API Keys.
Copia la Test key (sk_test_*). Si después necesitás tráfico productivo, repetí con la Live key (sk_live_* o sk_proj_*).

Guardala como variable de entorno:

export RQE_API_KEY="sk_test_tu_test_key"

No hardcodees keys en código del lado del cliente. Usalas solo desde backend.

Enviar tu primer email

Usá POST /v1/send-email con HTML directo:

curl -X POST https://api.reallyquickemails.com/v1/send-email \
  -H "Authorization: Bearer $RQE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient_email": "tu@email.com",
    "sender_email": "noreply@tudominio.com",
    "sender_name": "Tu Empresa",
    "subject": "Hola desde ReallyQuickEmails",
    "html_body": "<h1>¡Hola!</h1><p>Este es mi primer email.</p>"
  }'

const res = await fetch('https://api.reallyquickemails.com/v1/send-email', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.RQE_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    recipient_email: 'tu@email.com',
    sender_email: 'noreply@tudominio.com',
    sender_name: 'Tu Empresa',
    subject: 'Hola desde ReallyQuickEmails',
    html_body: '<h1>¡Hola!</h1><p>Este es mi primer email.</p>',
  }),
});

const data = await res.json();
console.log(data); // { message: 'Email sent successfully', email_id: '...', project_id: '...' }

import os, requests

res = requests.post(
    'https://api.reallyquickemails.com/v1/send-email',
    headers={
        'Authorization': f"Bearer {os.environ['RQE_API_KEY']}",
        'Content-Type': 'application/json',
    },
    json={
        'recipient_email': 'tu@email.com',
        'sender_email': 'noreply@tudominio.com',
        'sender_name': 'Tu Empresa',
        'subject': 'Hola desde ReallyQuickEmails',
        'html_body': '<h1>¡Hola!</h1><p>Este es mi primer email.</p>',
    },
)
print(res.json())

Validar la respuesta

Una respuesta exitosa retorna 200 OK con:

{
  "message": "Email sent successfully",
  "email_id": "550e8400-e29b-41d4-a716-446655440000",
  "project_id": "123e4567-e89b-12d3-a456-426614174000"
}

Errores comunes:

Status	Causa	Solución
`401`	API key inválida o sin prefijo correcto	Verificá `Authorization: Bearer sk_test_...`
`403`	Sender no verificado	Verificá `sender_email` en Dominios
`400`	Falta campo requerido	Revisá `recipient_email`, `sender_email`, `html_body`

Validar el envío en el dashboard

En Activity del dashboard, vas a ver el envío con flag is_test=true (porque usaste sk_test_*). Filtros disponibles: estado, fecha, sender, recipient.

Cuando el destinatario abra el email, el evento opened llega al webhook_url_dev de tu proyecto si está configurado. Ver Webhooks para detalles.

Próximos pasos

Listo para producción

Repetí el envío con sk_live_* (o sk_proj_*) cuando quieras enviar a clientes reales. Configurá webhook_url y inbound_webhook_url en tu proyecto.

Templates con variables — Handlebars, {{variables}}, helpers.
Programar envíos — fechas futuras con timezones.
Adjuntos — PDFs, .ics calendar events.
Send batch — hasta 12,500 destinatarios por request.
Webhooks — recibir eventos delivered/opened/clicked/bounced.