Partner quickstart

Esta guía es para partners: integradores que ofrecen email a sus propios clientes usando RQE por debajo (patrón reseller). El modelo es: un cliente, un proyecto. Creas un proyecto por cada cliente con tu partner-key y recibes su API key para operarlo. Cada cliente queda aislado de verdad — sus datos, sus dominios, sus límites y sus estadísticas.

Empieza acá

Crea el proyecto del cliente

Con tu partner-key (sk_partner_..., la emite RQE al habilitar tu cuenta de partner), creas un proyecto por cliente y recibes su api_key.

curl -X POST https://api.reallyquickemails.com/v1/partner/projects \
  -H "Authorization: Bearer sk_partner_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Cliente", "external_key": "tu-id-interno" }'

{ "project_id": "…", "slug": "cliente", "api_key": "sk_proj_…" }

Guarda la api_key de forma segura. El external_key hace la llamada idempotente: reintentarla devuelve el mismo proyecto en vez de duplicarlo.

Registra su dominio

Con la api_key del cliente, das de alta su dominio y recibes los registros DNS que debe publicar.

curl -X POST https://api.reallyquickemails.com/domains/register \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "cliente.com" }'

Para que los publique de un click, usa Domain Connect: GET /domains/cliente.com/domain-connect devuelve una URL firmada que crea los registros en su proveedor.

Este es el paso donde se traba la mayoría de las integraciones: el cliente final tiene que tocar su DNS. El link de un click es lo que más ayuda.

Registra su reply domain (opcional)

Para que las respuestas lleguen a nombre@reply.cliente.com en vez de a una dirección con token:

curl -X POST https://api.reallyquickemails.com/domains/reply \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "cliente.com" }'

Espera la verificación

Cuando el cliente publique el DNS, recibes el webhook domain.verified — no hace falta pollear. Ver Webhooks.

Envía y mide

Con la misma api_key, envía transaccional o en lote. Para ver cómo va cada cliente:

curl https://api.reallyquickemails.com/v1/partner/projects/{project_id}/stats \
  -H "Authorization: Bearer sk_partner_xxxxxxxxxxxx"

Y GET /v1/partner/projects lista toda tu cartera.

Revisa la salud de tus clientes

GET /domains/health devuelve, por cada dominio del proyecto: si puede enviar, cómo está su autenticación, cuánto envió, cómo rebota y qué le falta — en texto que puedes reenviar directo a tu cliente.

curl "https://api.reallyquickemails.com/domains/health" \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx"

{
  "summary": { "total": 3, "healthy": 1, "warning": 1, "critical": 1 },
  "data": [
    {
      "domain": "cliente.com",
      "status": "critical",
      "can_send": true,
      "sent": 4501,
      "hard_bounce_rate": 0.42,
      "issues": ["Verificado solo por email (un click), sin dominio: no permite DKIM propio, reply domain ni tracking domain."]
    }
  ]
}

Presta atención a can_send: true con status: critical. El correo sale con 200 y nada parece roto, pero va sin DKIM del dominio de tu cliente — su reputación se mezcla con la de todos y no puede usar reply domain ni tracking domain propios.Es el hueco más común en las integraciones de partner, y no aparece como error en ningún otro lado.

Ver Dominios para la respuesta completa.

Mira el hard bounce, no el total de rebotes. Los proveedores calculan el umbral de suspensión (~5%) sobre los rebotes permanentes; los temporales no cuentan. Un dominio puede mostrar 12% de rebote total y estar por debajo del 1% de hard bounce.Y pide a cada cliente que publique el DKIM de su propio dominio: es lo que hace que su reputación de envío sea suya y no se mezcle con la de los demás.

Alternativa — varios clientes en un proyecto

Si prefieres gestionar una sola credencial y tus clientes nunca van a necesitar límites ni acceso propios, puedes tenerlos a todos dentro de un proyecto.

	Un proyecto por cliente	Varios clientes en un proyecto
Credencial	`sk_partner_` + una por cliente	una sola `sk_proj_`
Dominio y reply domain por cliente	sí	sí
Métricas por cliente	`/v1/partner/projects/:id/stats`	`/v1/domain-stats`
Rate limits por cliente	sí	no, del proyecto entero
Tu cliente entra al dashboard RQE	sí	no es posible

En ese modelo el alta de dominios y reply domains es igual, pero con tu propia key. Un proyecto puede tener varios reply domains: cada envío resuelve el que corresponde al dominio del remitente. Para depurar un cliente concreto:

curl "https://api.reallyquickemails.com/v1/activity?sender_domain=cliente.com&status=bounced" \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx"

Y para sus métricas agregadas, GET /v1/domain-stats — ver Activity. GET /domains/health también funciona acá, y devuelve una entrada por cada dominio de cliente.

Registra el dominio de tu cliente

Con la API key de tu proyecto, das de alta el dominio de cada cliente y recibes los registros DNS que debe publicar.

curl -X POST https://api.reallyquickemails.com/domains/register \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "cliente.com" }'

Para que publique el DNS de un click, usa Domain Connect: GET /domains/cliente.com/domain-connect devuelve una URL firmada que crea los registros en su proveedor.

Registra su reply domain (opcional)

Para que las respuestas lleguen a nombre@reply.cliente.com en vez de a una dirección con token:

curl -X POST https://api.reallyquickemails.com/domains/reply \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "cliente.com" }'

Puedes registrar uno por cada cliente en el mismo proyecto. Cada envío resuelve el reply domain que corresponde al dominio del remitente. Para verificar uno concreto, pasa domain en el body de POST /domains/reply/verify.

Espera la verificación

Cuando tu cliente publique el DNS, recibes el webhook domain.verified — no hace falta pollear. Ver Webhooks.

Envía en su nombre

Con la misma API key, envía transaccional o en lote usando su dominio como remitente.

Depura y mide por cliente

Los envíos de un cliente concreto:

curl "https://api.reallyquickemails.com/v1/activity?sender_domain=cliente.com&status=bounced" \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx"

Y sus métricas agregadas, con entregas, rebotes, aperturas y clicks:

curl "https://api.reallyquickemails.com/v1/domain-stats" \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx"

Ver Activity y domain-stats.

Mira hard_bounce_rate, no el total de rebotes. Los proveedores calculan el umbral de suspensión (~5%) sobre los rebotes permanentes; los temporales no cuentan. Un dominio puede mostrar 12% de rebote total y estar por debajo del 1% de hard bounce.Y pide a cada cliente que publique el DKIM de su propio dominio: es lo que hace que su reputación de envío sea suya y no se mezcle con la de los demás.

Con un agente de IA (MCP)

{
  "mcpServers": {
    "reallyquickemails-partner": {
      "url": "https://mcp.reallyquickemails.com/mcp",
      "headers": { "Authorization": "Bearer sk_partner_xxxxxxxxxxxx" }
    }
  }
}

Ver MCP · modo partner.

Referencia

Dominios — alta, verificación, salud, reply domain y tracking domain.
Activity — ?sender_domain= y /v1/domain-stats.
API pública — envío.
Webhooks — domain.verified y eventos de email.
Partner / Provisioning — /v1/partner/projects (camino B).

Guías

La app

Conceptos

API Reference

Empieza acá

Revisa la salud de tus clientes

Alternativa — varios clientes en un proyecto

Con un agente de IA (MCP)

Referencia

​Empieza acá

​Revisa la salud de tus clientes

​Alternativa — varios clientes en un proyecto

​Con un agente de IA (MCP)

​Referencia

Empieza acá

Revisa la salud de tus clientes

Alternativa — varios clientes en un proyecto

Con un agente de IA (MCP)

Referencia