Dominios - ReallyQuickEmails

Endpoints para gestionar dominios de envío: registro, verificación DNS, estado y perfil de remitente. Base URL: https://api.reallyquickemails.com

Autenticacion

Todos los endpoints de dominios requieren Secret Key:

Header	Tipo	Requerido	Descripción
`Authorization`	string	Sí	`Bearer sk_proj_...`
`Content-Type`	string	Sí*	`application/json` (en POST/PUT).

Flujo de integracion

Si automatizas el alta de dominios desde tu propia aplicación, este es el recorrido completo:

Registra el dominio

POST /domains/register retorna los 8 registros DNS en dns_records, ya listos para mostrar.

Ofrece la configuración en un clic

GET /domains/{domain}/domain-connect. Si retorna supported: true, redirige al usuario a apply_url y su proveedor crea los registros solo. Si no, muestra los registros para configuración manual.

Verifica

POST /domains/{domain}/verify consulta el estado real y actualiza los registros. Llámalo cuando el usuario indique que ya configuró su DNS.

Confirma antes de enviar

Recibe domain.verified por webhook, o consulta GET /domains/{domain}/status. El dominio puede enviar cuando can_send: true.

No pollees: escucha el webhook. Cuando un dominio queda verificado, RQE emite domain.verified hacia la URL de webhooks de tu proyecto (y domain.failed si la verificación falla). Se emite una sola vez, en la transición. Ver Webhooks.

Los dominios en pending se re-verifican solos, sin que llames a nada: con frecuencia alta el primer día y espaciándose a medida que el alta envejece. Si tu usuario publica el DNS días después del registro, igual recibirás el webhook. POST /verify sigue siendo útil para respuesta inmediata cuando el usuario dice “ya lo configuré”.

SPF y DMARC se verifican cada 6 horas, no en el momento. Un barrido server-side los resuelve por DNS y escribe su status en dns_records, así que pueden llegarte verified o mismatch sin que llames a nada — no necesitas resolverlos por tu cuenta. Dos salvedades: can_send no los considera (de ellos dependen la entregabilidad y la alineación DMARC, no el permiso de envío), y POST /domains/{domain}/verify reescribe ambos a not_set hasta el siguiente barrido.

POST /domains/register

Registra un dominio de envío: crea la identidad de envío, genera los registros DNS y crea el perfil de remitente.

Request Body

Campo	Tipo	Requerido	Descripción
`domain`	string	Sí	Dominio a registrar (ej. `mitienda.com`).
`sender_name`	string	Sí	Nombre del remitente (ej. `Mi Tienda`).
`sender_email`	string	Sí	Dirección de correo del remitente. Debe terminar en `@{domain}` (ej. `ventas@mitienda.com`).
`external_key`	string	No	Clave externa para integraciones de terceros.

Ejemplo

cURL

curl -X POST https://api.reallyquickemails.com/domains/register \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx" \
  -d '{
    "domain": "mitienda.com",
    "sender_name": "Mi Tienda",
    "sender_email": "ventas@mitienda.com"
  }'

Respuesta 201 Created

{
  "success": true,
  "identity_id": "8a1f6e2c-3b4d-4f5a-9c6e-7d8f9a0b1c2d",
  "domain": "mitienda.com",
  "verification_status": "pending",
  "sender_profile_id": "123e4567-e89b-12d3-a456-426614174000",
  "sender": {
    "from_name": "Mi Tienda",
    "from_email": "ventas@mitienda.com",
    "domain_authenticated": false
  },
  "verification_token": "abcdef1234567890abcdef1234567890",
  "dkim_tokens": ["abc123", "def456", "ghi789"],
  "dns_records": [
    {
      "id": "f1a2b3c4-d5e6-4f70-8a91-b2c3d4e5f607",
      "record_type": "TXT",
      "name": "_amazonses",
      "value": "abcdef1234567890abcdef1234567890",
      "purpose": "ses_verification",
      "status": "not_set",
      "ttl_hint": 300
    },
    {
      "id": "a2b3c4d5-e6f7-4081-92a3-b4c5d6e7f809",
      "record_type": "CNAME",
      "name": "abc123._domainkey",
      "value": "abc123.dkim.amazonses.com",
      "purpose": "dkim",
      "status": "not_set",
      "ttl_hint": 1800
    },
    {
      "id": "b3c4d5e6-f708-4192-a3b4-c5d6e7f8091a",
      "record_type": "CNAME",
      "name": "def456._domainkey",
      "value": "def456.dkim.amazonses.com",
      "purpose": "dkim",
      "status": "not_set",
      "ttl_hint": 1800
    },
    {
      "id": "c4d5e6f7-0819-42a3-b4c5-d6e7f8091a2b",
      "record_type": "CNAME",
      "name": "ghi789._domainkey",
      "value": "ghi789.dkim.amazonses.com",
      "purpose": "dkim",
      "status": "not_set",
      "ttl_hint": 1800
    },
    {
      "id": "d5e6f708-192a-43b4-c5d6-e7f8091a2b3c",
      "record_type": "TXT",
      "name": "@",
      "value": "v=spf1 include:amazonses.com ~all",
      "purpose": "spf",
      "status": "not_set",
      "ttl_hint": 300
    },
    {
      "id": "e6f70819-2a3b-44c5-d6e7-f8091a2b3c4d",
      "record_type": "TXT",
      "name": "_dmarc",
      "value": "v=DMARC1; p=none; rua=mailto:d-a1b2c3d4-e5f6-7890-abcd-ef1234567890@dmarc.reallyquickemails.com",
      "purpose": "dmarc",
      "status": "not_set",
      "ttl_hint": 300
    },
    {
      "id": "f708192a-3b4c-45d6-e7f8-091a2b3c4d5e",
      "record_type": "MX",
      "name": "send",
      "value": "10 feedback-smtp.us-east-1.amazonses.com",
      "purpose": "return_path",
      "status": "not_set",
      "ttl_hint": 300
    },
    {
      "id": "0819192a-4c5d-46e7-f809-1a2b3c4d5e6f",
      "record_type": "TXT",
      "name": "send",
      "value": "v=spf1 include:amazonses.com ~all",
      "purpose": "return_path",
      "status": "not_set",
      "ttl_hint": 300
    }
  ]
}

Cada registro DNS incluye: id, record_type (TXT, CNAME o MX), name, value, purpose (ses_verification, dkim, spf, dmarc, return_path), status y ttl_hint (TTL sugerido en segundos). Valores de status: not_set, propagating, mismatch, verified.

Registros DNS generados

#	Tipo	Nombre	Propósito	Notas
1	TXT	`_amazonses`	Verificación de dominio	Valor generado automáticamente al registrar
2-4	CNAME	`{token}._domainkey`	DKIM	3 registros, tokens generados automáticamente
5	TXT	`@` (raíz del dominio)	SPF	`v=spf1 include:amazonses.com ~all`
6	TXT	`_dmarc`	DMARC	`v=DMARC1; p=none; rua=mailto:d-{identity_id}@dmarc.reallyquickemails.com`
7	MX	`send`	Return-Path	`10 feedback-smtp.us-east-1.amazonses.com`
8	TXT	`send`	Return-Path	`v=spf1 include:amazonses.com ~all`

El rua del DMARC apunta a un buzón de RQE, no a una casilla tuya: así recibimos los reportes agregados por ti y los puedes ver en el detalle del dominio. El dominio nace en p=none (solo monitoreo) para no mandar a spam el correo legítimo de tus otras herramientas mientras se alinea.

Los nombres son relativos al dominio. Con dominio mitienda.com, el registro _amazonses se configura como _amazonses.mitienda.com. Algunos proveedores agregan el dominio automáticamente, así que solo ingresas _amazonses.

Configura los registros DNS en tu proveedor y llama a POST /domains/{domain}/verify para validar. Ver Deliverability.

Codigos de Error

Código	Descripción
`400`	Campos requeridos faltantes, dominio con formato inválido, o `sender_email` no termina en `@{domain}`.
`401`	API Key inválida.
`409`	El dominio está asociado a otro remitente verificado.
`500`	Error interno al registrar el dominio.

El alta es idempotente. Si el dominio ya tiene un registro incompleto, la operación lo reconcilia en vez de fallar: responde 201 con reused: true y sus registros DKIM existentes. Reintentar un alta que quedó a medias es seguro y no crea duplicados.

GET /domains/:domain/dns-records

Retorna los registros DNS almacenados con su último estado conocido, sin consultas externas.

Parametros de Ruta

Parámetro	Tipo	Descripción
`domain`	string	Dominio registrado (ej. `mitienda.com`).

Ejemplo

cURL

curl -X GET https://api.reallyquickemails.com/domains/mitienda.com/dns-records \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx"

Respuesta 200 OK

{
  "success": true,
  "identity_id": "8a1f6e2c-3b4d-4f5a-9c6e-7d8f9a0b1c2d",
  "domain": "mitienda.com",
  "verification_status": "pending",
  "dns_records": [
    {
      "id": "f1a2b3c4-d5e6-4f70-8a91-b2c3d4e5f607",
      "record_type": "TXT",
      "name": "_amazonses",
      "value": "abcdef1234567890abcdef1234567890",
      "purpose": "ses_verification",
      "status": "not_set",
      "ttl_hint": 300,
      "last_checked_at": null
    },
    {
      "id": "a2b3c4d5-e6f7-4081-92a3-b4c5d6e7f809",
      "record_type": "CNAME",
      "name": "abc123._domainkey",
      "value": "abc123.dkim.amazonses.com",
      "purpose": "dkim",
      "status": "not_set",
      "ttl_hint": 1800,
      "last_checked_at": null
    },
    {
      "id": "d5e6f708-192a-43b4-c5d6-e7f8091a2b3c",
      "record_type": "TXT",
      "name": "@",
      "value": "v=spf1 include:amazonses.com ~all",
      "purpose": "spf",
      "status": "not_set",
      "ttl_hint": 300,
      "last_checked_at": null
    },
    {
      "id": "f708192a-3b4c-45d6-e7f8-091a2b3c4d5e",
      "record_type": "MX",
      "name": "send",
      "value": "10 feedback-smtp.us-east-1.amazonses.com",
      "purpose": "return_path",
      "status": "not_set",
      "ttl_hint": 300,
      "last_checked_at": null
    }
  ]
}

status por registro: not_set, propagating, mismatch o verified. last_checked_at es null hasta la primera verificación con POST /domains/{domain}/verify.

SPF y DMARC no los reporta AWS: los resuelve un barrido propio por DNS cada 6 horas. Tras un POST /verify vuelven a not_set hasta ese barrido.

Codigos de Error

Código	Descripción
`401`	API Key inválida.
`404`	Dominio no encontrado en el proyecto.

POST /domains/:domain/verify

Consulta el estado DNS directamente en la infraestructura de envío, actualiza el estado almacenado de los registros y retorna si el dominio puede enviar.

Parametros de Ruta

Parámetro	Tipo	Descripción
`domain`	string	Dominio registrado (ej. `mitienda.com`).

Ejemplo

cURL

curl -X POST https://api.reallyquickemails.com/domains/mitienda.com/verify \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx"

Respuesta 200 OK

{
  "success": true,
  "identity_id": "8a1f6e2c-3b4d-4f5a-9c6e-7d8f9a0b1c2d",
  "domain": "mitienda.com",
  "verification_status": "verified",
  "sender_profile": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "from_name": "Mi Tienda",
    "from_email": "ventas@mitienda.com",
    "domain_authenticated": true
  },
  "details": {
    "domain_verification": "Success",
    "dkim_verification": "Success",
    "mail_from_status": "Pending"
  },
  "dns_records": [
    {
      "id": "f1a2b3c4-d5e6-4f70-8a91-b2c3d4e5f607",
      "record_type": "TXT",
      "name": "_amazonses",
      "value": "abcdef1234567890abcdef1234567890",
      "purpose": "ses_verification",
      "status": "verified",
      "last_checked_at": "2025-03-10T18:45:00.000Z"
    },
    {
      "id": "a2b3c4d5-e6f7-4081-92a3-b4c5d6e7f809",
      "record_type": "CNAME",
      "name": "abc123._domainkey",
      "value": "abc123.dkim.amazonses.com",
      "purpose": "dkim",
      "status": "verified",
      "last_checked_at": "2025-03-10T18:45:00.000Z"
    },
    {
      "id": "f708192a-3b4c-45d6-e7f8-091a2b3c4d5e",
      "record_type": "MX",
      "name": "send",
      "value": "10 feedback-smtp.us-east-1.amazonses.com",
      "purpose": "return_path",
      "status": "propagating",
      "last_checked_at": "2025-03-10T18:45:00.000Z"
    }
  ],
  "verification_token": "abcdef1234567890abcdef1234567890",
  "dkim_tokens": ["abc123", "def456", "ghi789"],
  "can_send": true
}

La verificación comprueba tres aspectos:

Verificación de dominio — El registro TXT _amazonses está configurado.
DKIM — Los 3 registros CNAME de DKIM están configurados y propagados.
MAIL FROM — Los registros de Return-Path en send (MX y TXT) están configurados.

Campos clave:

Campo	Descripción
`verification_status`	`verified` (dominio y DKIM verificados), `failed` (alguna verificación falló) o `pending`.
`details.domain_verification`	Estado crudo de la verificación de dominio: `Success`, `Pending`, `Failed`, `TemporaryFailure` o `NotStarted`.
`details.dkim_verification`	Estado crudo de DKIM (mismos valores).
`details.mail_from_status`	Estado crudo de MAIL FROM (mismos valores).
`sender_profile`	Perfil de remitente activo del dominio, o `null` si no existe.
`can_send`	`true` cuando dominio y DKIM están verificados.

can_send es true cuando details.domain_verification y details.dkim_verification son Success (equivalente a verification_status: "verified"). MAIL FROM no es obligatorio para enviar, pero mejora la entregabilidad.

Codigos de Error

Código	Descripción
`401`	API Key inválida.
`404`	Dominio no encontrado en el proyecto.
`500`	Error al comunicarse con la infraestructura de envío.

GET /domains/:domain/status

Retorna el estado de verificación almacenado, sin consultar la infraestructura de envío. Rápido, ideal para polling desde la interfaz.

Parametros de Ruta

Parámetro	Tipo	Descripción
`domain`	string	Dominio registrado (ej. `mitienda.com`).

Ejemplo

cURL

curl -X GET https://api.reallyquickemails.com/domains/mitienda.com/status \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx"

Respuesta 200 OK

{
  "success": true,
  "identity_id": "8a1f6e2c-3b4d-4f5a-9c6e-7d8f9a0b1c2d",
  "domain": "mitienda.com",
  "verification_status": "verified",
  "external_key": null,
  "sender_profile": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "from_name": "Mi Tienda",
    "from_email": "ventas@mitienda.com",
    "domain_authenticated": true
  },
  "dns_records_summary": [
    { "purpose": "ses_verification", "records_count": 1, "all_verified": true },
    { "purpose": "dkim", "records_count": 3, "all_verified": true },
    { "purpose": "spf", "records_count": 1, "all_verified": false },
    { "purpose": "dmarc", "records_count": 1, "all_verified": false },
    { "purpose": "return_path", "records_count": 1, "all_verified": true }
  ],
  "can_send": true,
  "last_verified_at": "2025-03-10T18:45:00.000Z"
}

dns_records_summary agrupa los registros por propósito: records_count es cuántos hay y all_verified indica si todos están en status: "verified". can_send es true cuando verification_status es verified. last_verified_at es la última actualización del estado del dominio.

Codigos de Error

Código	Descripción
`401`	API Key inválida.
`404`	Dominio no encontrado en el proyecto.

GET /domains

Con el parámetro domain busca uno por nombre. Sin él, lista los dominios del proyecto de forma paginada — para reconciliar N dominios en una request en lugar de N consultas.

Query Parameters

Parámetro	Tipo	Requerido	Descripción
`domain`	string	No	Busca un dominio puntual. Si lo envías, los demás parámetros se ignoran.
`limit`	integer	No	Resultados por página. Default `50`, máximo `200`.
`offset`	integer	No	Desplazamiento para paginar. Default `0`.
`status`	string	No	Filtra por estado: `pending`, `verified` o `failed`.

Ejemplo — listado

cURL

curl -X GET "https://api.reallyquickemails.com/domains?limit=50&status=verified" \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx"

Respuesta 200 OK

{
  "success": true,
  "domains": [
    {
      "identity_id": "8a1f6e2c-3b4d-4f5a-9c6e-7d8f9a0b1c2d",
      "domain": "mitienda.com",
      "verification_status": "verified",
      "external_key": null,
      "can_send": true,
      "sender_profile": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "from_name": "Mi Tienda",
        "from_email": "ventas@mitienda.com",
        "domain_authenticated": true
      },
      "created_at": "2026-03-01T12:00:00.000Z"
    }
  ],
  "total": 128,
  "limit": 50,
  "offset": 0,
  "has_more": true
}

Los dominios vienen ordenados por fecha de creación descendente. total es la cantidad total que coincide con el filtro; pagina mientras has_more sea true.

Ejemplo — lookup de uno

cURL

curl -X GET "https://api.reallyquickemails.com/domains?domain=mitienda.com" \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx"

Respuesta 200 OK

{
  "success": true,
  "identity_id": "8a1f6e2c-3b4d-4f5a-9c6e-7d8f9a0b1c2d",
  "domain": "mitienda.com",
  "verification_status": "verified",
  "external_key": null,
  "can_send": true,
  "sender_profile": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "from_name": "Mi Tienda",
    "from_email": "ventas@mitienda.com",
    "domain_authenticated": true
  },
  "created_at": "2025-03-01T12:00:00.000Z"
}

Codigos de Error

Código	Descripción
`401`	API Key inválida.
`404`	Dominio no encontrado (solo en el lookup: el listado vacío retorna `200`).

GET /domains/health

Salud de envío de todos tus dominios en una sola llamada: cuál puede enviar, cómo está su autenticación, cuánto envió, cómo rebota y qué hacer con cada uno. Pensado para integradores que operan a varios clientes. Cruza en el servidor lo que de otro modo tendrías que juntar a mano entre GET /domains, los registros DNS y /v1/domain-stats.

El campo issues viene en texto plano y accionable — puedes reenviarlo directo a tu cliente final sin traducirlo.

Query Parameters

Parámetro	Tipo	Default	Descripción
`days`	integer	`30`	Ventana de métricas, entre `1` y `90`.

Ejemplo

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

{
  "success": true,
  "period_days": 30,
  "summary": { "total": 3, "healthy": 1, "warning": 1, "critical": 1 },
  "data": [
    {
      "domain": "cliente-ok.com",
      "status": "healthy",
      "can_send": true,
      "sent": 56248,
      "hard_bounce_rate": 0.31,
      "auth": { "ses": "verified", "spf": "verified", "dmarc": "verified", "dkim": "verified" },
      "issues": []
    },
    {
      "domain": "cliente-pendiente.com",
      "status": "warning",
      "can_send": true,
      "sent": 2509,
      "hard_bounce_rate": 0.44,
      "auth": { "ses": "verified", "spf": "verified", "dmarc": "not_set", "dkim": "verified" },
      "issues": [
        "DMARC sin configurar: sin él no hay reportes ni política ante suplantación."
      ]
    },
    {
      "domain": "gmail.com",
      "status": "critical",
      "can_send": true,
      "sent": 14049,
      "hard_bounce_rate": 1.12,
      "auth": { "ses": null, "spf": null, "dmarc": null, "dkim": null },
      "issues": [
        "Se envía desde este dominio pero no está registrado como identidad. Sin verificarlo no hay autenticación posible."
      ]
    }
  ]
}

Campos de respuesta

Campo	Descripción
`status`	`healthy` · `warning` · `critical`. Ver la tabla de abajo.
`can_send`	Si el dominio tiene identidad verificada en SES. `true` no significa que llegue bien — ver nota.
`sent`	Envíos en la ventana pedida (`period_days`).
`hard_bounce_rate`	Porcentaje de rebotes permanentes. Los temporales no cuentan.
`auth.ses`	`verified` · `pending` · `failed`, o `null` si no hay identidad de dominio.
`auth.spf`	Estado del registro TXT de SPF resuelto por DNS.
`auth.dmarc`	Estado del registro `_dmarc`. `not_set` si no existe.
`auth.dkim`	Estado de los 3 CNAME de DKIM. Basta con que uno falte para que no sea `verified`.
`issues`	Qué le falta a este dominio, en texto accionable. Vacío si está sano.

Los dominios vienen ordenados por volumen: primero donde el arreglo rinde más.

Cómo se calcula `status`

Estado	Cuándo
`critical`	El dominio no puede enviar, o envía sin identidad de dominio verificada, o su hard bounce supera el 5%.
`warning`	Puede enviar pero le falta algo: DKIM propio, DMARC, o el hard bounce pasó del 3%.
`healthy`	Verificado, autenticado y con rebote bajo. `issues` vacío.

can_send: true con status: critical es el caso que más cuesta. Significa que los emails salen con 200 y nadie ve un error, pero van sin DKIM del dominio del cliente: se firman con el dominio compartido de la plataforma, así que su reputación se mezcla con la de todos y no puede usar reply domain ni tracking domain propios.Aparece cuando el dominio se verificó solo por email (el enlace de un clic) en vez de por DNS, o cuando se envía desde un dominio ajeno como gmail.com — que no se puede autenticar de ninguna forma porque no controlas su DNS.

Codigos de Error

Código	Descripción
`401`	API Key inválida.
`500`	No se pudo calcular la salud de los dominios.

GET /domains/:domain/domain-connect

Configuración de DNS en un clic. Si el proveedor DNS del dominio soporta el estándar Domain Connect, retorna una URL firmada que crea los 8 registros automáticamente: el usuario final solo confirma en la pantalla de su proveedor, sin copiar nada a mano. Úsalo justo después de POST /domains/register. Si el proveedor no lo soporta, cae de vuelta a mostrar los registros de dns_records para configuración manual.

Cobertura medida sobre dominios reales: alrededor del 50% soporta Domain Connect. Cloudflare está operativo. Siempre debes manejar el caso supported: false.

Parametros de Ruta

Parámetro	Tipo	Descripción
`domain`	string	Dominio registrado (ej. `mitienda.com`).

Query Parameters

Parámetro	Tipo	Requerido	Descripción
`redirect_uri`	string	No	URL a la que vuelve el usuario tras aplicar los registros. Ver nota.

redirect_uri solo acepta hosts de ReallyQuickEmails (app.reallyquickemails.com) y de desarrollo local. Si envías el dominio de tu propia aplicación, la respuesta es supported: false con reason: "invalid_redirect_uri". Omite el parámetro: la apply_url sigue siendo válida, solo que el usuario termina en la página de su proveedor DNS en vez de volver a tu aplicación.

Ejemplo

cURL

curl -X GET "https://api.reallyquickemails.com/domains/mitienda.com/domain-connect" \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx"

Respuesta 200 OK — proveedor compatible

{
  "supported": true,
  "provider_name": "Cloudflare",
  "zone": "mitienda.com",
  "host": "",
  "apply_url": "https://dash.cloudflare.com/domainconnect/v2/domainTemplates/providers/reallyquickemails.com/services/email-sending/apply?domain=mitienda.com&sesVerify=...&sig=...&key=_dck1"
}

Redirige al usuario a apply_url. Al confirmar, su proveedor crea los registros. Después llama a POST /domains/{domain}/verify para confirmar el estado. Respuesta 200 OK — proveedor no compatible

{
  "supported": false,
  "reason": "no_domain_connect",
  "zone": "mitienda.com",
  "host": ""
}

Campos de respuesta

Campo	Descripción
`supported`	`true` si hay un flujo de un clic disponible para este dominio.
`apply_url`	URL firmada a la que debes redirigir. Solo presente cuando `supported: true`.
`provider_name`	Nombre del proveedor DNS detectado (ej. `Cloudflare`, `GoDaddy`).
`zone`	Zona DNS detectada. Para subdominios, el dominio raíz que tiene los NS.
`host`	Prefijo del subdominio dentro de la zona. Cadena vacía si el dominio es la raíz.
`reason`	Motivo por el que no hay flujo disponible. Solo presente cuando `supported: false`.

Valores de `reason`

Valor	Significado
`no_zone`	No se pudo determinar la zona DNS del dominio.
`no_domain_connect`	El proveedor DNS no publica soporte para Domain Connect.
`no_sync_flow`	El proveedor soporta Domain Connect pero no el flujo interactivo.
`template_not_onboarded`	El proveedor no tiene habilitada la plantilla de ReallyQuickEmails.
`identity_missing_tokens`	El dominio aún no tiene tokens generados. Registra el dominio primero.
`invalid_redirect_uri`	El `redirect_uri` enviado no está permitido.
`signing_key_not_configured`	Error de configuración del servicio. Contacta a soporte.

supported: false no es un error: la respuesta es 200 OK. Muestra los registros DNS de GET /domains/{domain}/dns-records para que el usuario los configure manualmente.

Codigos de Error

Código	Descripción
`401`	API Key inválida.
`404`	Dominio no encontrado en el proyecto.
`500`	Error al consultar el proveedor DNS.

POST /domains/:domain/recreate

Elimina y recrea la identidad de envío del dominio. Útil cuando DKIM queda atascado en estado fallido.

Parametros de Ruta

Parámetro	Tipo	Descripción
`domain`	string	Dominio registrado (ej. `mitienda.com`).

Ejemplo

cURL

curl -X POST https://api.reallyquickemails.com/domains/mitienda.com/recreate \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx"

Respuesta 200 OK

{
  "success": true,
  "identity_id": "8a1f6e2c-3b4d-4f5a-9c6e-7d8f9a0b1c2d",
  "domain": "mitienda.com",
  "verification_status": "pending",
  "verification_token": "abcdef1234567890abcdef1234567890",
  "dkim_tokens": ["abc123", "def456", "ghi789"],
  "dns_records": [
    {
      "id": "f1a2b3c4-d5e6-4f70-8a91-b2c3d4e5f607",
      "record_type": "TXT",
      "name": "_amazonses",
      "value": "abcdef1234567890abcdef1234567890",
      "purpose": "ses_verification",
      "status": "not_set",
      "ttl_hint": 300
    }
  ],
  "message": "Domain identity recreated in SES. DNS records may already be propagated - verify in a few seconds."
}

Conserva el dominio y el perfil de remitente, regenera los registros DNS y reinicia verification_status a pending. Luego llama a POST /domains/{domain}/verify. Si los registros ya estaban propagados, la verificación puede completarse en segundos.

Codigos de Error

Código	Descripción
`401`	API Key inválida.
`404`	Dominio no encontrado en el proyecto.
`500`	Error al recrear la identidad de envío.

DELETE /domains/:domain

Elimina el dominio de la infraestructura de envío y desactiva su perfil de remitente.

Parametros de Ruta

Parámetro	Tipo	Descripción
`domain`	string	Dominio a eliminar (ej. `mitienda.com`).

Ejemplo

cURL

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

Respuesta 200 OK

{
  "success": true,
  "domain": "mitienda.com",
  "message": "Domain and associated sender profile removed"
}

El mismo dominio puede registrarse de nuevo más adelante.

Tras eliminarlo, deberás registrar el dominio y configurar los registros DNS de nuevo para enviar desde él.

Codigos de Error

Código	Descripción
`401`	API Key inválida.
`404`	Dominio no encontrado en el proyecto.

PUT /domains/:domain/sender

Actualiza el perfil de remitente asociado a un dominio.

Parametros de Ruta

Parámetro	Tipo	Descripción
`domain`	string	Dominio asociado (ej. `mitienda.com`).

Request Body

Campo	Tipo	Requerido	Descripción
`sender_name`	string	Sí	Nombre visible del remitente.
`sender_email`	string	Sí	Dirección de correo del remitente. Debe terminar en `@{domain}`.
`reply_email`	string	No	Dirección de correo para respuestas (Reply-To).

Ejemplo

cURL

curl -X PUT https://api.reallyquickemails.com/domains/mitienda.com/sender \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx" \
  -d '{
    "sender_name": "Equipo Mi Tienda",
    "sender_email": "ventas@mitienda.com",
    "reply_email": "soporte@mitienda.com"
  }'

Respuesta 200 OK

{
  "success": true,
  "sender_profile_id": "123e4567-e89b-12d3-a456-426614174000",
  "from_name": "Equipo Mi Tienda",
  "from_email": "ventas@mitienda.com",
  "domain_authenticated": true
}

El campo reply_email se guarda pero no se incluye en la respuesta.

Codigos de Error

Código	Descripción
`400`	Falta `sender_name` o `sender_email`, o `sender_email` no coincide con el dominio.
`401`	API Key inválida.
`404`	Dominio o perfil de remitente no encontrado en el proyecto.

Reply domain (Reply-To limpio, sin token)

Configura un dominio de reply branded por proyecto (reply.tudominio.com) para que el Reply-To de los envíos API salga limpio —localpart@reply.tudominio.com— en vez del token codificado. El envío y la resolución de las respuestas son automáticos una vez verificado. Sin reply domain configurado, se usa el token de siempre. Cómo afecta el webhook: Webhooks · reply domain.

Modelo para integradores (varios reply domains por proyecto). El reply domain pertenece al proyecto de la API key con la que llamas, y un proyecto puede tener varios: cada envío resuelve el que corresponde al dominio del remitente.Para ofrecer reply limpio a tus propios clientes desde un mismo proyecto, registra el dominio de cada uno con tu key: POST /domains/reply { "domain": "phrasso.com" } y las respuestas de ese cliente llegan a nombre@reply.phrasso.com. Para verificar uno concreto, pasa domain en el body de POST /domains/reply/verify.También puedes darle un proyecto propio a cada cliente, con su key — ver Partner quickstart para cuándo conviene cada modelo.

POST /domains/reply

Registra el reply domain: verifica la identidad en SES para recibir y devuelve los 2 registros DNS que el cliente debe publicar.

Request Body

Campo	Tipo	Requerido	Descripción
`domain`	string	Sí	Dominio del cliente (ej. `phrasso.com`). RQE arma `reply.phrasso.com`.

cURL

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

Respuesta 201 Created

{
  "success": true,
  "reply_domain": "reply.phrasso.com",
  "reply_domain_status": "pending",
  "dns_records": [
    { "record_type": "TXT", "name": "_amazonses.reply.phrasso.com", "value": "<token>", "purpose": "ses_verification", "ttl_hint": 300 },
    { "record_type": "MX", "name": "reply.phrasso.com", "value": "inbound-smtp.us-east-1.amazonaws.com", "priority": 10, "purpose": "reply_inbound", "ttl_hint": 300 }
  ],
  "message": "Publica estos 2 registros en el DNS del dominio y luego llama a POST /domains/reply/verify."
}

El cliente publica esos 2 registros (TXT de verificación SES + MX que enruta las respuestas al inbound de RQE). Luego llama a verify.

POST /domains/reply/verify

Consulta SES y marca el reply domain como verified cuando el TXT ya propagó. A partir de ahí, los envíos API del proyecto salen con el Reply-To limpio.

cURL

curl -X POST https://api.reallyquickemails.com/domains/reply/verify \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx"

Respuesta 200 OK

{
  "success": true,
  "reply_domain": "reply.phrasso.com",
  "reply_domain_status": "verified",
  "ses_status": "Success",
  "can_receive": true
}

reply_domain_status: pending (aún sin verificar) · verified (en uso) · failed. can_receive es true cuando SES puede recibir en el dominio.

GET /domains/reply

Estado y registros DNS del reply domain del proyecto. reply_domain: null si no hay ninguno configurado.

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

DELETE /domains/reply

Quita el reply domain (lo saca del ruteo de inbound, borra la identidad SES y limpia el proyecto). Los envíos vuelven al Reply-To con token.

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

Tracking domain (links de click con tu dominio)

Envuelve los links de click-tracking con tu propio subdominio (links.tudominio.com) en vez del compartido de RQE. Aísla la reputación del tracking y alinea los links con tu From. Se configura con un solo registro CNAME.

El tracking domain se cambia, nunca se borra: los links de los emails ya enviados dependen de que el dominio siga resolviendo. Por eso no hay endpoint DELETE — para migrar, publica el CNAME nuevo y llama a PUT con el nuevo dominio.

Estos endpoints cuelgan de /api/projects/:projectId. El :projectId es el UUID de tu proyecto —el project_id que devuelve cualquier respuesta de envío— y debe coincidir con el proyecto de tu API key.

GET /api/projects/:projectId/tracking-domain

Estado actual del tracking domain del proyecto.

cURL

curl https://api.reallyquickemails.com/api/projects/:projectId/tracking-domain \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx"

Respuesta 200 OK

{
  "domain": "links.tudominio.com",
  "status": "verified",
  "verified_at": "2026-07-20T12:00:00.000Z",
  "cname": { "name": "links.tudominio.com", "target": "track.reallyquickemails.com" }
}

domain, status y cname son null si no hay ninguno configurado.

PUT /api/projects/:projectId/tracking-domain

Setea o cambia el tracking domain. Queda en pending hasta verificar. Debe ser un subdominio propio (ej. links.tudominio.com), nunca un dominio de RQE.

Request Body

Campo	Tipo	Requerido	Descripción
`domain`	string	Sí	Subdominio propio, ej. `links.tudominio.com`.

cURL

curl -X PUT https://api.reallyquickemails.com/api/projects/:projectId/tracking-domain \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "links.tudominio.com" }'

Respuesta 200 OK

{
  "domain": "links.tudominio.com",
  "status": "pending",
  "cname": { "name": "links.tudominio.com", "target": "track.reallyquickemails.com" },
  "tls_registered": true
}

Publica el CNAME links.tudominio.com → track.reallyquickemails.com en tu DNS y luego llama a verify.

Código	Error	Motivo
`400`	`INVALID_DOMAIN`	No es un subdominio válido, o es un dominio de RQE.
`502`	`TLS_REGISTRATION_FAILED`	No se pudo registrar el dominio para emitir TLS. Reintenta.

POST /api/projects/:projectId/tracking-domain/verify

Chequea el DNS y marca verified si el CNAME ya resuelve a nuestro target (soporta el CNAME flattening de Cloudflare comparando registros A).

cURL

curl -X POST https://api.reallyquickemails.com/api/projects/:projectId/tracking-domain/verify \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx"

Respuesta 200 OK

{
  "domain": "links.tudominio.com",
  "status": "verified",
  "verified": true,
  "detail": "cname",
  "cname": { "name": "links.tudominio.com", "target": "track.reallyquickemails.com" }
}

verified: false con status: "pending" si el DNS aún no propagó (detail explica el motivo). Responde 404 NO_DOMAIN si no hay tracking domain configurado.

Verificacion de Email (Magic Link)

Alternativa a la verificación de dominio completo: verifica un email individual como remitente sin configurar DNS. Se envía un email de verificación; al hacer clic en el enlace, el email queda verificado para enviar.

Es más rápida pero no incluye DKIM/SPF. Para mejor deliverability, verifica el dominio completo.

Cuando el estado cambia (de pending a verified o failed), RQE emite el webhook sender.verified o sender.failed. Ver Webhooks.

POST /domains/verify-email

Inicia la verificación de un email como remitente enviándole un enlace de verificación.

Request Body

Campo	Tipo	Requerido	Descripción
`sender_email`	string	Sí	Email a verificar como remitente.
`sender_name`	string	Sí	Nombre visible del remitente.
`external_key`	string	No	Clave externa para integraciones.

Ejemplo

cURL

curl -X POST https://api.reallyquickemails.com/domains/verify-email \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sender_email": "ventas@gmail.com",
    "sender_name": "Mi Empresa"
  }'

Respuesta 201

{
  "success": true,
  "identity_id": "550e8400-e29b-41d4-a716-446655440000",
  "sender_email": "ventas@gmail.com",
  "verification_status": "pending",
  "sender_profile_id": "123e4567-e89b-12d3-a456-426614174000",
  "sender": {
    "from_name": "Mi Empresa",
    "from_email": "ventas@gmail.com",
    "email_verified": false,
    "domain_authenticated": false
  },
  "message": "Verification email sent. The sender must click the link in the email to verify."
}

El remitente recibirá un email con un enlace. Al hacer clic, su email queda verificado.

Errores

Código	Descripción
`400`	`sender_email` o `sender_name` faltantes, o formato de email inválido
`401`	API Key inválida
`409`	Email ya registrado en este proyecto

GET /domains/verify-email/status

Consulta el estado de verificación de un email en la infraestructura de envío en tiempo real.

Query Parameters

Parámetro	Tipo	Requerido	Descripción
`email`	string	Sí	Email a consultar.

Ejemplo

cURL

curl "https://api.reallyquickemails.com/domains/verify-email/status?email=ventas@gmail.com" \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx"

Respuesta 200

{
  "success": true,
  "identity_id": "550e8400-e29b-41d4-a716-446655440000",
  "sender_email": "ventas@gmail.com",
  "verification_status": "verified",
  "sender_profile": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "from_name": "Mi Empresa",
    "from_email": "ventas@gmail.com",
    "email_verified": true,
    "domain_authenticated": false
  },
  "can_send": true
}

sender_profile puede ser null si no existe un perfil de remitente activo. can_send es true cuando verification_status es verified.

Estados de verificacion

Estado	Descripción
`pending`	Email de verificación enviado, esperando clic del remitente
`verified`	Remitente verificado, listo para enviar
`failed`	Verificación fallida

Errores

Código	Descripción
`400`	`email query parameter is required`
`401`	API Key inválida
`404`	Email no encontrado en el proyecto

POST /domains/verify-email/resend

Reenvía el email de verificación al remitente. Solo válido mientras la verificación está en pending.

Request Body

Campo	Tipo	Requerido	Descripción
`sender_email`	string	Sí	Email al que reenviar.

Ejemplo

cURL

curl -X POST https://api.reallyquickemails.com/domains/verify-email/resend \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sender_email": "ventas@gmail.com"
  }'

Respuesta 200

{
  "success": true,
  "message": "Verification email resent",
  "sender_email": "ventas@gmail.com"
}

Errores

Código	Descripción
`400`	`sender_email` faltante, o la verificación no está en estado `pending`
`401`	API Key inválida
`404`	Email no encontrado en el proyecto

DELETE /domains/verify-email

Elimina un email verificado como remitente; el mismo email puede registrarse de nuevo más adelante.

Query Parameters

Parámetro	Tipo	Requerido	Descripción
`email`	string	Sí	Email a eliminar.

Ejemplo

cURL

curl -X DELETE "https://api.reallyquickemails.com/domains/verify-email?email=ventas@gmail.com" \
  -H "Authorization: Bearer sk_proj_xxxxxxxxxxxx"

Respuesta 200

{
  "success": true,
  "sender_email": "ventas@gmail.com",
  "message": "Email identity and associated sender profile removed"
}

Errores

Código	Descripción
`400`	`email query parameter is required`
`401`	API Key inválida
`404`	Email no encontrado en el proyecto

​Autenticacion

​Flujo de integracion

​POST /domains/register

​Request Body

​Ejemplo

​Registros DNS generados

​Codigos de Error

​GET /domains/:domain/dns-records

​Parametros de Ruta

​Ejemplo

​Codigos de Error

​POST /domains/:domain/verify

​Parametros de Ruta

​Ejemplo

​Codigos de Error

​GET /domains/:domain/status

​Parametros de Ruta

​Ejemplo

​Codigos de Error

​GET /domains

​Query Parameters

​Ejemplo — listado

​Ejemplo — lookup de uno

​Codigos de Error

​GET /domains/health

​Query Parameters

​Ejemplo

​Campos de respuesta

​Cómo se calcula status

​Codigos de Error

​GET /domains/:domain/domain-connect

​Parametros de Ruta

​Query Parameters

​Ejemplo

​Campos de respuesta

​Valores de reason

​Codigos de Error

​POST /domains/:domain/recreate

​Parametros de Ruta

​Ejemplo

​Codigos de Error

​DELETE /domains/:domain

​Parametros de Ruta

​Ejemplo

​Codigos de Error

​PUT /domains/:domain/sender

​Parametros de Ruta

​Request Body

​Ejemplo

​Codigos de Error

​Reply domain (Reply-To limpio, sin token)

​POST /domains/reply

​Request Body

​POST /domains/reply/verify

​GET /domains/reply

​DELETE /domains/reply

​Tracking domain (links de click con tu dominio)

​GET /api/projects/:projectId/tracking-domain

​PUT /api/projects/:projectId/tracking-domain

​Request Body

​POST /api/projects/:projectId/tracking-domain/verify

​Verificacion de Email (Magic Link)

​POST /domains/verify-email

​Request Body

​Ejemplo

​Errores

​GET /domains/verify-email/status

​Query Parameters

​Ejemplo

​Estados de verificacion

​Errores

​POST /domains/verify-email/resend

​Request Body

​Ejemplo

​Errores

​DELETE /domains/verify-email

​Query Parameters

​Ejemplo

​Errores

Autenticacion

Flujo de integracion

POST /domains/register

Request Body

Ejemplo

Registros DNS generados

Codigos de Error

GET /domains/:domain/dns-records

Parametros de Ruta

Ejemplo

Codigos de Error

POST /domains/:domain/verify

Parametros de Ruta

Ejemplo

Codigos de Error

GET /domains/:domain/status

Parametros de Ruta

Ejemplo

Codigos de Error

GET /domains

Query Parameters

Ejemplo — listado

Ejemplo — lookup de uno

Codigos de Error

GET /domains/health

Query Parameters

Ejemplo

Campos de respuesta

Cómo se calcula `status`

Codigos de Error

GET /domains/:domain/domain-connect

Parametros de Ruta

Query Parameters

Ejemplo

Campos de respuesta

Valores de `reason`

Codigos de Error

POST /domains/:domain/recreate

Parametros de Ruta

Ejemplo

Codigos de Error

DELETE /domains/:domain

Parametros de Ruta

Ejemplo

Codigos de Error

PUT /domains/:domain/sender

Parametros de Ruta

Request Body

Ejemplo

Codigos de Error

Reply domain (Reply-To limpio, sin token)

POST /domains/reply

Request Body

POST /domains/reply/verify

GET /domains/reply

DELETE /domains/reply

Tracking domain (links de click con tu dominio)

GET /api/projects/:projectId/tracking-domain

PUT /api/projects/:projectId/tracking-domain

Request Body

POST /api/projects/:projectId/tracking-domain/verify

Verificacion de Email (Magic Link)

POST /domains/verify-email

Request Body

Ejemplo

Errores

GET /domains/verify-email/status

Query Parameters

Ejemplo

Estados de verificacion

Errores

POST /domains/verify-email/resend

Request Body

Ejemplo

Errores

DELETE /domains/verify-email

Query Parameters

Ejemplo

Errores