# ReallyQuickEmails Docs

> Documentación pública de ReallyQuickEmails — API, guías, conceptos, webhooks.

- [Introducción](/): API de email transaccional y campañas de ReallyQuickEmails — base URL, autenticación Bearer (sk_proj_/sk_live_/sk_test_), POST /v1/send-email, /v1/send-template-email, /v1/send-batch, leads, events, activity, dominios, webhooks firmados, inbound replies, automatizaciones, SDK Node.js y acceso markdown para agentes IA (/llms.txt, /llms-full.txt).

- **Guías**
- Guías: Onboarding y guías de uso paso a paso.
  - [Quickstart](/guides/quickstart): Primer envío con POST /v1/send-email usando la Test key (sk_test_) — ejemplos curl/JavaScript/Python, respuesta con email_id, errores 401/400 y verificación en Activity.
  - [SDK de Node.js](/guides/sdk-nodejs): SDK oficial @reallyquickemails/sdk para Node.js 18+, Bun, Deno, Cloudflare Workers y Vercel Edge — módulos emails (send, sendBatch), leads, automations, events y senders, manejo de errores tipado e idempotencia con idempotencyKey.
  - [API Keys](/guides/api-keys): Keys Live (sk_proj_/sk_live_) vs Test (sk_test_) — comportamiento de test mode (cuota, is_test, webhooks _dev), dónde obtener y regenerar keys, header Idempotency-Key, dry_run en POST /send-email y seguridad.
  - [Autenticación](/guides/authentication): Autenticación Bearer con Secret Keys (sk_proj_/sk_live_/sk_test_) en el header Authorization — endpoints cubiertos (envío, dominios, activity, leads, eventos), dónde obtener la key y errores 401.
  - [Templates y Variables](/guides/templates): Variables en templates — Handlebars completo ({{#if}}, {{#each}}, helpers formatCurrency/multiply/formatDate/default/json) con data en POST /send-email, y sustitución simple ({var}, fallbacks ||, loops) con variables en POST /v1/send-template-email; template_id vs template_internal_id.
  - [Programar Envíos](/guides/scheduling): Envío programado con scheduled_at y timezone en POST /send-email — timestamps ISO 8601 con offset, lenguaje natural en inglés, zonas IANA, error 400 por fechas pasadas, respuesta scheduled_send_id/scheduled_for y limitaciones (un destinatario, sin adjuntos).
  - [Adjuntos](/guides/attachments): Adjuntos en POST /send-email — campo attachments (filename, url o content base64, contentType), tipos permitidos application/pdf y text/calendar, límites de 10 archivos / 10 MB y validación asíncrona vía Activity API.
  - [Preguntas Frecuentes](/guides/faq): FAQ: send-email vs send-template-email vs send-batch, límites de envío, programación con scheduled_at, supresión de destinatarios, verificación DNS de dominios, variables y helpers de templates, campañas, API keys, errores 401 e Idempotency-Key.

- **Conceptos**
- Conceptos: Cómo funciona ReallyQuickEmails por dentro. Lectura recomendada para entender deliverability, tracking y modos Live/Test.
  - [Modos Live y Test](/concepts/test-mode): Modos Live (sk_proj_/sk_live_) y Test (sk_test_) por prefijo de API key — flag is_test en webhooks, routing a webhook_url vs webhook_url_dev, cuota mensual, suppression list compartida y regeneración independiente de keys.
  - [Webhook environments](/concepts/webhook-environments): Campo environment en POST /v1/send-email, /v1/send-template-email y /v1/send-batch — webhooks por ambiente custom (staging, qa, preview), configuración de webhook_environments, echo en el payload, error 400 ENVIRONMENT_NOT_CONFIGURED, diferencias con Live/Test e interacción con Idempotency-Key.
  - [Deliverability y autenticación](/concepts/deliverability): SPF, DKIM, DMARC y custom MAIL FROM — qué verifica cada chequeo, los 7 registros DNS que genera ReallyQuickEmails (POST /domains/register, POST /domains/:domain/verify, can_send), y factores de reputación (bounces, complaints, warming) que deciden si llegas al inbox.
  - [Tracking de eventos](/concepts/tracking): Eventos webhook por email enviado (email.send, email.delivery, email.bounce, email.complaint, email.deliverydelay, email.open, email.click, email.inbound), bounces hard vs soft con supresión automática, open tracking por pixel, click tracking por redirect 302 y verificación HMAC del payload.

- **API Reference**
- API Reference: Referencia completa de endpoints de la API.
  - [Enviar Email](/api-reference/send-email): Envía un correo electrónico de forma inmediata o programada, con plantillas Handlebars, adjuntos y múltiples destinatarios.
  - [API Pública v1](/api-reference/public-api): Envía emails individuales, con plantilla y en lote con POST /v1/send-email, /v1/send-template-email y /v1/send-batch.
  - [Dominios](/api-reference/domains): Registra y verifica dominios de envío, consulta sus registros DNS y gestiona el perfil de remitente de cada dominio.
  - [Campañas](/api-reference/campaigns): Crea y envía campañas de email masivo con templates personalizados, variables por destinatario, lotes automáticos y rate limiting integrado.
  - [Webhooks](/api-reference/webhooks): Webhooks de ReallyQuickEmails — eventos email.send/delivery/bounce/complaint/reject/deliverydelay/open/click/inbound, headers X-RQE-Signature y X-RQE-Environment, verificación HMAC-SHA256, routing webhook_url/webhook_url_dev/webhook_environments, payload de replies con adjuntos, retries.
  - [Leads](/api-reference/leads): Crea, lista, actualiza y elimina leads, y gestiona sus segmentos, tags y atributos vía API.
  - [Events](/api-reference/events): POST /v1/events, POST /v1/events/bulk y GET /v1/events: tracking de eventos custom con auto-creación de leads, envío masivo de hasta 1,000 eventos y consulta con filtros y paginación.
  - [Activity](/api-reference/activity): Consulta el estado de los envíos por ID o con filtros — entregas, aperturas, clicks, rebotes y reclamos.