Partner / Provisioning

Si integras RQE como plataforma para tus propios clientes (patrón partner/reseller), estos endpoints te dejan crear y configurar un proyecto-cliente completo por API: su dominio de envío con el pack DNS, su remitente, su API key y su webhook. Todo con tu partner-key, sin pedirle nada a la key del cliente. Base URL: https://api.reallyquickemails.com

Cada cliente = un proyecto. El dominio, el reply domain, los límites y las estadísticas son por proyecto, así que cada cliente tuyo es un proyecto RQE independiente con su propia API key. Estos endpoints crean, configuran y listan esos proyectos dentro de tu organización de partner.

Autenticación

Los endpoints de partner usan una partner-key dedicada (distinta de las API keys de proyecto):

Authorization: Bearer sk_partner_xxxxxxxxxxxx

La partner-key está asociada a tu organización y solo puede operar proyectos dentro de ella. Es dedicada y revocable sin afectar tus envíos. Se emite desde RQE al habilitar tu cuenta de partner. Una key ausente o inválida responde 401. Un projectId que no pertenece a tu organización responde 404, nunca 403: desde afuera, un proyecto ajeno es indistinguible de uno que no existe.

La partner-key no envía correo. Sirve para provisionar y configurar. Para enviar, gestionar contactos o consultar actividad de un cliente, usa la api_key (sk_proj_...) de su proyecto.

Alta completa en una llamada

Es el camino recomendado. Un solo POST crea el proyecto, registra el dominio de envío con el pack DNS completo y deja el remitente creado sobre ese dominio.

Crea el cliente entero

POST /v1/partner/projects con name, domain y sender. Recibes project_id, slug, la api_key del cliente, los registros DNS y el link público de verificación.

Reenvía el link de verificación

domain.verification_url es una página pública que muestra los registros y verifica con un botón. La abre el cliente final sin cuenta RQE: es lo único que necesitas mandarle.

Espera el webhook domain.verified

No poleas. RQE reintenta la verificación sola y avisa por webhook cuando el DNS propaga. Ver Webhooks.

Opera en su nombre

Con la api_key del cliente, envía, gestiona contactos y lee actividad — todo aislado a ese proyecto.

POST /v1/partner/projects

Crea un proyecto-cliente dentro de tu organización de partner. El slug y la api_key se generan automáticamente. El único campo obligatorio es name. domain y sender son opcionales y nuevos: si los envías, el alta queda completa en esta misma llamada. Si no, el endpoint responde igual que siempre.

Compatibilidad: si ya integraste el flujo anterior, no necesitas cambiar nada. La llamada con solo { "name": "..." } sigue siendo válida y su respuesta no cambió. Los campos nuevos se agregan, no reemplazan.

Request Body

Campo	Tipo	Requerido	Descripción
`name`	string	Sí	Nombre del cliente (ej. `Phrasso`).
`external_key`	string	No	Tu identificador interno del cliente (máx. 200 caracteres). Hace la llamada idempotente.
`domain`	string	No	Nuevo. Dominio de envío del cliente (ej. `phrasso.com`). Va siempre junto con `sender`.
`sender`	object	No	Nuevo. `{ "name": "Phrasso", "email": "hola@phrasso.com" }`. Va siempre junto con `domain`.
`webhook_url`	string	No	URL HTTPS de webhooks del proyecto. Si se omite, hereda la de tu proyecto raíz.
`timezone`	string	No	Zona horaria IANA (ej. `America/Lima`).
`country`	string	No	Código de país del cliente.

domain y sender viajan juntos o no viajan. SES no registra un dominio sin una dirección From, así que no hay forma de dar de alta uno sin el otro. Si mandas solo uno, la respuesta es 400 antes de crear nada: SENDER_REQUIRED_FOR_DOMAIN o DOMAIN_REQUIRED_FOR_SENDER. Y si el correo no termina en el dominio, 400 SENDER_DOMAIN_MISMATCH.

Ejemplo mínimo — solo el proyecto

El flujo de siempre, sin cambios. Crea el proyecto y devuelve su API key; el dominio y el remitente los configuras después con los endpoints de abajo.

cURL
Python

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

import requests

resp = requests.post(
    "https://api.reallyquickemails.com/v1/partner/projects",
    headers={"Authorization": "Bearer sk_partner_xxxxxxxxxxxx"},
    json={"name": "Phrasso"},
)
print(resp.json())

Respuesta 201 Created

{
  "project_id": "c22e3647-0e4b-4d71-99e2-651dbbac3eb2",
  "slug": "phrasso",
  "api_key": "sk_proj_xxxxxxxxxxxxxxxxxxxxxxxx"
}

Ejemplo — alta completa

Con domain y sender, la misma llamada registra el dominio y crea el remitente. La respuesta suma las claves domain y sender a las tres de arriba.

cURL
Python

curl -X POST https://api.reallyquickemails.com/v1/partner/projects \
  -H "Authorization: Bearer sk_partner_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Phrasso",
    "external_key": "cli_8842",
    "domain": "phrasso.com",
    "sender": { "name": "Phrasso", "email": "hola@phrasso.com" },
    "webhook_url": "https://tuapp.com/hooks/rqe",
    "timezone": "America/Lima",
    "country": "PE"
  }'

import requests

resp = requests.post(
    "https://api.reallyquickemails.com/v1/partner/projects",
    headers={"Authorization": "Bearer sk_partner_xxxxxxxxxxxx"},
    json={
        "name": "Phrasso",
        "external_key": "cli_8842",
        "domain": "phrasso.com",
        "sender": {"name": "Phrasso", "email": "hola@phrasso.com"},
    },
)
print(resp.json())

Respuesta 201 Created

{
  "project_id": "c22e3647-0e4b-4d71-99e2-651dbbac3eb2",
  "slug": "phrasso",
  "api_key": "sk_proj_xxxxxxxxxxxxxxxxxxxxxxxx",
  "domain": {
    "domain": "phrasso.com",
    "identity_id": "8a1f6e2c-3b4d-4f5a-9c6e-7d8f9a0b1c2d",
    "verification_status": "pending",
    "can_send": false,
    "verification_url": "https://app.reallyquickemails.com/verificar-dominio/9f1c2d3e-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
    "reply_domain": { "domain": "reply.phrasso.com", "status": "pending" },
    "tracking_domain": { "domain": "links.phrasso.com", "status": "pending" },
    "records": [
      { "record_type": "TXT",   "name": "_amazonses",        "fqdn": "_amazonses.phrasso.com",        "value": "abcdef1234567890abcdef1234567890",            "purpose": "ses_verification",  "status": "not_set", "ttl_hint": 300 },
      { "record_type": "CNAME", "name": "abc123._domainkey", "fqdn": "abc123._domainkey.phrasso.com", "value": "abc123.dkim.amazonses.com",                    "purpose": "dkim",              "status": "not_set", "ttl_hint": 1800 },
      { "record_type": "CNAME", "name": "def456._domainkey", "fqdn": "def456._domainkey.phrasso.com", "value": "def456.dkim.amazonses.com",                    "purpose": "dkim",              "status": "not_set", "ttl_hint": 1800 },
      { "record_type": "CNAME", "name": "ghi789._domainkey", "fqdn": "ghi789._domainkey.phrasso.com", "value": "ghi789.dkim.amazonses.com",                    "purpose": "dkim",              "status": "not_set", "ttl_hint": 1800 },
      { "record_type": "TXT",   "name": "@",                 "fqdn": "phrasso.com",                   "value": "v=spf1 include:amazonses.com ~all",            "purpose": "spf",               "status": "not_set", "ttl_hint": 300 },
      { "record_type": "TXT",   "name": "_dmarc",            "fqdn": "_dmarc.phrasso.com",            "value": "v=DMARC1; p=none; rua=mailto:d-8a1f6e2c@dmarc.reallyquickemails.com", "purpose": "dmarc", "status": "not_set", "ttl_hint": 300 },
      { "record_type": "MX",    "name": "send",              "fqdn": "send.phrasso.com",              "value": "10 feedback-smtp.us-east-1.amazonses.com",     "purpose": "return_path",       "status": "not_set", "ttl_hint": 300 },
      { "record_type": "TXT",   "name": "send",              "fqdn": "send.phrasso.com",              "value": "v=spf1 include:amazonses.com ~all",            "purpose": "return_path",       "status": "not_set", "ttl_hint": 300 },
      { "record_type": "CNAME", "name": "links.phrasso.com", "fqdn": "links.phrasso.com",             "value": "track.reallyquickemails.com",                  "purpose": "tracking",          "status": "not_set", "ttl_hint": 300 },
      { "record_type": "TXT",   "name": "_amazonses.reply.phrasso.com", "fqdn": "_amazonses.reply.phrasso.com", "value": "fedcba0987654321fedcba0987654321", "purpose": "reply_verification", "status": "not_set", "ttl_hint": 300 },
      { "record_type": "MX",    "name": "reply.phrasso.com", "fqdn": "reply.phrasso.com",             "value": "inbound-smtp.us-east-1.amazonaws.com", "priority": 10, "purpose": "reply_inbound", "status": "not_set", "ttl_hint": 300 }
    ]
  },
  "sender": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "from_name": "Phrasso",
    "from_email": "hola@phrasso.com",
    "sender_source": "manual",
    "domain_authenticated": false,
    "email_verified": false,
    "can_send": false,
    "external_key": null,
    "created_at": "2026-07-22T16:00:00.000Z"
  }
}

La api_key se devuelve una sola vez, al crear. Guárdala de forma segura — es la credencial con la que operas ese proyecto-cliente. Si la pierdes, rótala con POST /v1/partner/projects/{projectId}/api-key/rotate.

Esa forma del objeto sender —con id, sender_source, can_send y created_at— es la misma en los cuatro lugares donde aparece un remitente: el alta, el alta de dominio, la creación de remitentes y el detalle del proyecto.

El pack DNS

domain.records trae el pack completo, no solo DKIM. Se deriva entero en una sola llamada.

El cliente publica fqdn, no name. Los registros que genera SES son relativos al dominio (_amazonses, @, _dmarc, send), mientras que los de reply y tracking son absolutos. fqdn es siempre el nombre listo para pegar en el DNS, sin pensar; name está para que coincida con lo que muestran los endpoints de /domains/*.

Tipo	`purpose`	Para qué
TXT	`ses_verification`	Prueba de propiedad del dominio.
CNAME	`dkim`	Firma DKIM del dominio del cliente. Son 3.
TXT	`spf`	SPF en la raíz.
TXT	`dmarc`	DMARC gestionado, en `p=none` para empezar a recibir reportes.
MX, TXT	`return_path`	MAIL FROM propio en `send.`: rebotes y quejas alineados.
CNAME	`tracking`	Links de click en `links.`, con el dominio del cliente.
TXT, MX	`reply_verification`, `reply_inbound`	Reply-To limpio en `reply.`, sin token.

status por registro: not_set, propagating, mismatch o verified. El campo priority aparece solo en el MX de reply; el de send lleva la prioridad dentro de value. Detalle de cada registro en Dominios.

El nombre records es solo de los endpoints bajo /v1/partner. Los de /domains/*, que se llaman con la API key del cliente, siguen devolviendo el array como dns_records. No cambió nada ahí.

El pack completo se arma cuando el dominio es nuevo. Reply y tracking son best effort: si alguno falla, el dominio queda registrado igual y el motivo viaja en warnings[]. Y si el proyecto ya tenía uno de los dos, ese paso se omite y se reporta en skipped[] — ver Pasos omitidos.

Idempotencia

Con external_key, reintentar la llamada devuelve el mismo proyecto en vez de duplicarlo. Es el campo con el que amarras el cliente de tu sistema al proyecto RQE: úsalo siempre. Si el external_key corresponde a un cliente deshabilitado, la respuesta es 409 PROJECT_DISABLED con el project_id en el cuerpo, para que sepas cuál reactivar.

Alta parcial

Solo aplica si enviaste domain y sender. Si el proyecto se crea pero el registro del dominio falla, la respuesta llega con partial: true y el detalle en errors[]. El proyecto y su api_key son válidos: reintenta el dominio con POST /v1/partner/projects/{projectId}/domains. Cada entrada de errors[] y de warnings[] es { step, error_code, error }. En errors[], step solo toma el valor domain: el remitente se crea dentro del registro del dominio, así que no hay un paso suyo que pueda fallar por separado. En warnings[], step toma reply_domain, tracking_domain o verification_link — los pasos best effort que no tumban el alta.

{
  "project_id": "c22e3647-0e4b-4d71-99e2-651dbbac3eb2",
  "slug": "phrasso",
  "api_key": "sk_proj_xxxxxxxxxxxxxxxxxxxxxxxx",
  "partial": true,
  "domain": null,
  "sender": null,
  "errors": [
    { "step": "domain", "error_code": "DOMAIN_SENDER_CONFLICT", "error": "phrasso.com ya está asociado a otro remitente verificado." }
  ]
}

Nunca descartamos un paso en silencio. Si no ves partial ni warnings en la respuesta, todo salió bien.

GET /v1/partner/projects

Lista los proyectos-cliente de tu organización.

cURL

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

Respuesta 200 OK

{
  "projects": [
    {
      "id": "c22e3647-0e4b-4d71-99e2-651dbbac3eb2",
      "name": "Phrasso",
      "slug": "phrasso",
      "external_key": "cli_8842",
      "created_at": "2026-07-22T16:00:00.000Z",
      "disabled_at": null
    }
  ]
}

GET /v1/partner/projects/{projectId}

Detalle de un proyecto-cliente. La respuesta tiene cuatro bloques: project, domains, senders y health. Es la llamada para construir tu propio panel de clientes: dice de un vistazo quién puede enviar bien y quién no.

cURL

curl https://api.reallyquickemails.com/v1/partner/projects/c22e3647-0e4b-4d71-99e2-651dbbac3eb2 \
  -H "Authorization: Bearer sk_partner_xxxxxxxxxxxx"

Respuesta 200 OK

{
  "project": {
    "project_id": "c22e3647-0e4b-4d71-99e2-651dbbac3eb2",
    "name": "Phrasso",
    "slug": "phrasso",
    "external_key": "cli_8842",
    "timezone": "America/Lima",
    "country": "PE",
    "webhook_url": "https://tuapp.com/hooks/rqe",
    "inbound_webhook_url": "https://tuapp.com/hooks/respuestas",
    "tracking_domain": "links.phrasso.com",
    "tracking_domain_status": "verified",
    "reply_domain": "reply.phrasso.com",
    "reply_domain_status": "verified",
    "disabled": false,
    "disabled_at": null,
    "created_at": "2026-07-22T16:00:00.000Z",
    "updated_at": "2026-07-24T09:12:00.000Z"
  },
  "domains": [
    {
      "identity_id": "8a1f6e2c-3b4d-4f5a-9c6e-7d8f9a0b1c2d",
      "domain": "phrasso.com",
      "verification_status": "verified",
      "can_send": true,
      "external_key": null,
      "created_at": "2026-07-22T16:00:00.000Z",
      "sender_profile": { "from_name": "Phrasso", "from_email": "hola@phrasso.com" },
      "verification_url": "https://app.reallyquickemails.com/verificar-dominio/9f1c2d3e-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
      "records": []
    }
  ],
  "senders": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "from_name": "Phrasso",
      "from_email": "hola@phrasso.com",
      "sender_source": "manual",
      "domain_authenticated": true,
      "email_verified": true,
      "can_send": true,
      "external_key": null,
      "created_at": "2026-07-22T16:00:00.000Z"
    }
  ],
  "health": {
    "period_days": 30,
    "status": "warning",
    "can_send": true,
    "dkim_verified": true,
    "domains_total": 2,
    "domains_authenticated": 1,
    "sent": 2509,
    "hard_bounce_rate": 0.44,
    "issues": ["DMARC sin configurar: sin él no hay reportes ni política ante suplantación."],
    "by_domain": [
      {
        "domain": "phrasso.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."]
      }
    ]
  }
}

El bloque `health`

Es por proyecto, no la forma de GET /domains/health: acá no hay summary ni data.

Campo	Descripción
`status`	`healthy` · `warning` · `critical`, para el cliente entero.
`can_send`	Si el cliente tiene al menos un dominio que puede enviar.
`dkim_verified`	Si el DKIM está verificado. Se llama así, no `dkim` — ese nombre es el de `by_domain[].auth`.
`domains_total`	Dominios registrados en el proyecto.
`domains_authenticated`	Cuántos de ellos están autenticados. La brecha entre ambos es el trabajo pendiente.
`sent`	Envíos en la ventana (`period_days`).
`hard_bounce_rate`	Rebote duro del cliente, ponderado por volumen — no el promedio de los porcentajes por dominio.
`issues`	Qué le falta, en texto accionable. Puedes reenviarlo tal cual a tu cliente.
`by_domain`	La salud de siempre por dominio, con `auth: { ses, spf, dmarc, dkim }`.

can_send: true con status: critical es el caso que más cuesta. El correo sale con 200 y nada parece roto, pero va sin DKIM del dominio del cliente. Ver Antes de enviar volumen.

PATCH /v1/partner/projects/{projectId}

Actualiza los datos del proyecto-cliente. Solo se tocan los campos que envías.

Request Body

Campo	Tipo	Descripción
`name`	string	Nuevo nombre del cliente. El `slug` no cambia.
`webhook_url`	string	URL HTTPS de webhooks salientes (eventos de email, `domain.verified`).
`inbound_webhook_url`	string	URL HTTPS de webhooks entrantes (respuestas de los destinatarios).
`timezone`	string	Zona horaria IANA.
`country`	string	Código de país.

Un PATCH sin ningún campo reconocido responde 400 EMPTY_PATCH.

webhook_url e inbound_webhook_url son dos campos independientes. Escribir uno no toca al otro. El alta los deja iguales solo porque nacen vacíos y hereda el mismo valor para los dos; a partir de ahí viven separados. Si tu integración tiene el saliente en null y el entrante apuntando a tu endpoint de respuestas, mandar webhook_url en un PATCH no te va a desviar el ruteo de respuestas.

cURL

curl -X PATCH https://api.reallyquickemails.com/v1/partner/projects/c22e3647-0e4b-4d71-99e2-651dbbac3eb2 \
  -H "Authorization: Bearer sk_partner_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "webhook_url": "https://tuapp.com/hooks/rqe/v2", "country": "CL" }'

Respuesta 200 OK — el proyecto actualizado, envuelto en project.

{
  "project": {
    "project_id": "c22e3647-0e4b-4d71-99e2-651dbbac3eb2",
    "name": "Phrasso",
    "slug": "phrasso",
    "external_key": "cli_8842",
    "timezone": "America/Lima",
    "country": "CL",
    "webhook_url": "https://tuapp.com/hooks/rqe/v2",
    "inbound_webhook_url": "https://tuapp.com/hooks/respuestas",
    "tracking_domain": "links.phrasso.com",
    "tracking_domain_status": "verified",
    "reply_domain": "reply.phrasso.com",
    "reply_domain_status": "verified",
    "disabled": false,
    "disabled_at": null,
    "created_at": "2026-07-22T16:00:00.000Z",
    "updated_at": "2026-07-24T09:12:00.000Z"
  }
}

El PATCH funciona sobre un cliente deshabilitado, a propósito. Así puedes arreglarle el webhook_url antes de reactivarlo, en vez de reactivarlo roto. El slug, en cambio, es estable de por vida: los links de tracking de los emails ya enviados dependen de él, y cambiar el name no lo mueve.

DELETE /v1/partner/projects/{projectId}

Deshabilita un proyecto-cliente (soft-disable). No se borra: los links de los emails ya enviados dependen de que el proyecto siga existiendo. Deja de enviar y queda con disabled_at.

cURL

curl -X DELETE https://api.reallyquickemails.com/v1/partner/projects/c22e3647-0e4b-4d71-99e2-651dbbac3eb2 \
  -H "Authorization: Bearer sk_partner_xxxxxxxxxxxx"

Respuesta 200 OK

{ "project_id": "c22e3647-0e4b-4d71-99e2-651dbbac3eb2", "disabled": true }

POST /v1/partner/projects/{projectId}/reactivate

Deshace el soft-disable: limpia disabled_at y el proyecto vuelve a poder enviar. Es idempotente — reactivar uno que ya está activo responde 200, nunca 409.

cURL

curl -X POST https://api.reallyquickemails.com/v1/partner/projects/c22e3647-0e4b-4d71-99e2-651dbbac3eb2/reactivate \
  -H "Authorization: Bearer sk_partner_xxxxxxxxxxxx"

Respuesta 200 OK — trae el proyecto completo, con la misma forma que el PATCH.

{
  "project_id": "c22e3647-0e4b-4d71-99e2-651dbbac3eb2",
  "disabled": false,
  "project": {
    "project_id": "c22e3647-0e4b-4d71-99e2-651dbbac3eb2",
    "name": "Phrasso",
    "slug": "phrasso",
    "disabled": false,
    "disabled_at": null,
    "updated_at": "2026-07-24T09:12:00.000Z"
  }
}

Dominios del cliente

Los mismos dominios que /domains/*, pero con tu partner-key y el projectId del cliente en la ruta: no necesitas tener a mano la api_key de cada uno.

POST /v1/partner/projects/{projectId}/domains

Registra el dominio de envío del cliente, deriva el pack DNS completo y crea el link público de verificación.

Campo	Tipo	Requerido	Descripción
`domain`	string	Sí	Dominio del cliente (ej. `phrasso.com`).
`sender`	object	Sí	`{ "name": "Phrasso", "email": "hola@phrasso.com" }`. El correo debe terminar en el dominio.
`external_key`	string	No	Tu identificador interno del dominio.

El remitente es obligatorio y va anidado en sender, no como sender_name y sender_email sueltos. SES no registra un dominio sin una dirección From, así que no hay alta de dominio “pelada”.

cURL

curl -X POST https://api.reallyquickemails.com/v1/partner/projects/c22e3647-0e4b-4d71-99e2-651dbbac3eb2/domains \
  -H "Authorization: Bearer sk_partner_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "phrasso.com",
    "sender": { "name": "Phrasso", "email": "hola@phrasso.com" }
  }'

Respuesta 201 Created — o 200 OK con reused: true si el dominio ya estaba registrado. El pack sale al nivel de arriba, sin envolver.

{
  "domain": "phrasso.com",
  "identity_id": "8a1f6e2c-3b4d-4f5a-9c6e-7d8f9a0b1c2d",
  "verification_status": "pending",
  "can_send": false,
  "reused": false,
  "verification_url": "https://app.reallyquickemails.com/verificar-dominio/9f1c2d3e-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
  "reply_domain": { "domain": "reply.phrasso.com", "status": "pending" },
  "tracking_domain": { "domain": "links.phrasso.com", "status": "pending" },
  "records": [
    { "record_type": "TXT", "name": "_amazonses", "fqdn": "_amazonses.phrasso.com", "value": "abcdef1234567890abcdef1234567890", "purpose": "ses_verification", "status": "not_set", "ttl_hint": 300 }
  ],
  "sender": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "from_name": "Phrasso",
    "from_email": "hola@phrasso.com",
    "sender_source": "manual",
    "domain_authenticated": false,
    "email_verified": false,
    "can_send": false,
    "external_key": null,
    "created_at": "2026-07-22T16:00:00.000Z"
  },
  "warnings": [],
  "skipped": []
}

El alta de dominio es idempotente. Repetirla sobre un dominio ya registrado responde 200 con reused: true y sus registros existentes, en vez de fallar. Reintentar un alta que quedó a medias es seguro.

Pasos omitidos

skipped[] es hermano de warnings[] y dice qué no se hizo y por qué. La diferencia importa: warnings[] es un paso que se intentó y falló; skipped[] es un paso que no se intentó, a propósito, porque hacerlo habría roto algo que ya funcionaba.

`step`	`reason_code`	Qué pasó
`pack`	`DOMAIN_ALREADY_REGISTERED`	El dominio ya estaba registrado. No se toca nada más del cliente.
`reply_domain`	`REPLY_DOMAIN_ALREADY_VERIFIED`	El cliente ya tenía un reply domain verificado.
`tracking_domain`	`TRACKING_DOMAIN_ALREADY_SET`	El cliente ya tenía un tracking domain configurado.

{
  "domain": "phrasso.com",
  "reused": true,
  "warnings": [],
  "skipped": [
    { "step": "pack", "reason_code": "DOMAIN_ALREADY_REGISTERED", "reason": "phrasso.com ya estaba registrado en este proyecto." }
  ]
}

Por qué no se pisa un reply domain que ya funciona. Registrar uno reescribe su estado a pending, y sobre un cliente que ya tenía las respuestas branded andando eso se las apaga hasta que alguien re-verifique. Preferimos omitir el paso y decírtelo antes que romperle el reply a un cliente en producción.

skipped[] solo se llena en este POST. GET /v1/partner/projects/{projectId}/domains/{domain} devuelve siempre skipped: [].

El verification_url es lo que le mandas al cliente final. Es una página pública que muestra sus registros con botón de copiar y un botón de verificar. No expone nada del proyecto: solo el dominio y sus registros, que son públicos por definición. No hace falta que tu cliente tenga cuenta RQE.

GET /v1/partner/projects/{projectId}/domains

Lista los dominios del cliente con su estado.

curl https://api.reallyquickemails.com/v1/partner/projects/c22e3647-0e4b-4d71-99e2-651dbbac3eb2/domains \
  -H "Authorization: Bearer sk_partner_xxxxxxxxxxxx"

Respuesta 200 OK

{
  "domains": [
    {
      "identity_id": "8a1f6e2c-3b4d-4f5a-9c6e-7d8f9a0b1c2d",
      "domain": "phrasso.com",
      "verification_status": "verified",
      "can_send": true,
      "external_key": null,
      "created_at": "2026-07-22T16:00:00.000Z",
      "sender_profile": { "from_name": "Phrasso", "from_email": "hola@phrasso.com" },
      "verification_url": "https://app.reallyquickemails.com/verificar-dominio/9f1c2d3e-4a5b-4c6d-8e9f-0a1b2c3d4e5f"
    }
  ]
}

verification_url puede venir en null. Los GET nunca crean el token: solo lo devuelven si ya existe. El que lo crea es POST /v1/partner/projects/{projectId}/domains y, como esa alta es idempotente, re-postear un dominio viejo es la forma de conseguirle el link. Si integraste antes de que existiera esta página, tus dominios anteriores van a mostrar null hasta que lo hagas.

GET /v1/partner/projects/{projectId}/domains/{domain}

Estado registro por registro, sin consultas externas. Es lo que muestras en tu panel mientras el cliente publica el DNS.

curl https://api.reallyquickemails.com/v1/partner/projects/c22e3647-0e4b-4d71-99e2-651dbbac3eb2/domains/phrasso.com \
  -H "Authorization: Bearer sk_partner_xxxxxxxxxxxx"

Respuesta 200 OK

{
  "domain": "phrasso.com",
  "identity_id": "8a1f6e2c-3b4d-4f5a-9c6e-7d8f9a0b1c2d",
  "verification_status": "pending",
  "can_send": false,
  "verification_url": "https://app.reallyquickemails.com/verificar-dominio/9f1c2d3e-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
  "reply_domain": { "domain": "reply.phrasso.com", "status": "pending" },
  "tracking_domain": { "domain": "links.phrasso.com", "status": "pending" },
  "records": [
    { "record_type": "CNAME", "name": "abc123._domainkey", "fqdn": "abc123._domainkey.phrasso.com", "value": "abc123.dkim.amazonses.com", "purpose": "dkim", "status": "verified", "ttl_hint": 1800 },
    { "record_type": "TXT", "name": "_dmarc", "fqdn": "_dmarc.phrasso.com", "value": "v=DMARC1; p=none; rua=mailto:d-8a1f6e2c@dmarc.reallyquickemails.com", "purpose": "dmarc", "status": "not_set", "ttl_hint": 300 }
  ],
  "skipped": []
}

skipped viene siempre vacío acá: solo el POST de alta lo llena. Un dominio que no existe en el proyecto responde 404 DOMAIN_NOT_FOUND.

POST /v1/partner/projects/{projectId}/domains/{domain}/verify

Fuerza la verificación del dominio de envío: consulta SES, actualiza el estado de los registros y responde si el dominio ya puede enviar. Llámalo cuando el cliente te diga “ya lo configuré”. Cubre identidad, DKIM y MAIL FROM. No verifica el reply domain ni el tracking domain.

curl -X POST https://api.reallyquickemails.com/v1/partner/projects/c22e3647-0e4b-4d71-99e2-651dbbac3eb2/domains/phrasso.com/verify \
  -H "Authorization: Bearer sk_partner_xxxxxxxxxxxx"

Respuesta 200 OK

{
  "domain": "phrasso.com",
  "identity_id": "8a1f6e2c-3b4d-4f5a-9c6e-7d8f9a0b1c2d",
  "verification_status": "verified",
  "can_send": true,
  "records": [
    { "record_type": "CNAME", "name": "abc123._domainkey", "fqdn": "abc123._domainkey.phrasso.com", "purpose": "dkim", "status": "verified" }
  ]
}

La respuesta también trae reply_domain y tracking_domain, pero de solo lectura: son el estado actual de cada uno, no algo que esta llamada haya verificado.

El verify a propósito no toca el tracking. Verificarlo escribe pending en cuanto un lookup de DNS no resuelve, y el envío exige verified para usar el dominio del cliente. Un DNS lento habría devuelto los links de todos sus correos al dominio compartido sin que nadie lo pidiera. Lo mismo vale para el reply. Para forzar esos dos hay endpoints propios, que se llaman con la API key del tenant: ver reply domain y tracking domain.

No hace falta pollear. Los dominios en pending se re-verifican solos —seguido el primer día, más espaciado después— y cuando quedan verificados RQE emite el webhook domain.verified al webhook_url del proyecto. verify sirve para respuesta inmediata, no para reemplazar el webhook.

Remitentes del cliente

GET /v1/partner/projects/{projectId}/senders

Lista los remitentes del cliente y cómo se verificó cada uno.

curl https://api.reallyquickemails.com/v1/partner/projects/c22e3647-0e4b-4d71-99e2-651dbbac3eb2/senders \
  -H "Authorization: Bearer sk_partner_xxxxxxxxxxxx"

Respuesta 200 OK

{
  "senders": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "from_name": "Phrasso",
      "from_email": "hola@phrasso.com",
      "sender_source": "manual",
      "domain_authenticated": true,
      "email_verified": true,
      "can_send": true,
      "external_key": null,
      "created_at": "2026-07-22T16:00:00.000Z"
    },
    {
      "id": "223e4567-e89b-12d3-a456-426614174001",
      "from_name": "Ventas",
      "from_email": "ventas@gmail.com",
      "sender_source": "magic_link",
      "domain_authenticated": false,
      "email_verified": true,
      "can_send": true,
      "external_key": null,
      "created_at": "2026-07-23T10:30:00.000Z"
    }
  ]
}

sender_source dice de dónde salió el remitente: manual (creado sobre un dominio registrado), magic_link (verificado por correo, sin DKIM), auto-own-email o admin. Un remitente con domain_authenticated: false y volumen es el patrón que rompe la entregabilidad.

POST /v1/partner/projects/{projectId}/senders

Crea un remitente. Por defecto exige un dominio verificado: es la regla que evita que un cliente nazca enviando sin autenticar.

Campo	Tipo	Requerido	Descripción
`name`	string	Sí	Nombre visible del remitente.
`email`	string	Sí	Dirección del remitente.
`external_key`	string	No	Tu identificador interno del remitente.
`allow_unauthenticated`	boolean	No	`true` para permitir la verificación por correo (magic link) cuando el dominio no está verificado. Default `false`.

name y email se aceptan sueltos en el cuerpo o anidados en sender: las dos formas funcionan.

cURL

curl -X POST https://api.reallyquickemails.com/v1/partner/projects/c22e3647-0e4b-4d71-99e2-651dbbac3eb2/senders \
  -H "Authorization: Bearer sk_partner_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Phrasso", "email": "hola@phrasso.com" }'

Respuesta 201 Created

{
  "sender": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "from_name": "Phrasso",
    "from_email": "hola@phrasso.com",
    "sender_source": "manual",
    "domain_authenticated": true,
    "email_verified": true,
    "can_send": true,
    "external_key": null,
    "created_at": "2026-07-22T16:00:00.000Z"
  },
  "path": "domain",
  "domain": "phrasso.com",
  "domain_verification_status": "verified"
}

path dice por dónde salió el remitente: domain (sobre el dominio verificado) o magic_link. En el camino del magic link la respuesta suma un warning avisando que ese remitente no tiene DKIM. Si el dominio del correo no está verificado y no enviaste el flag: Respuesta 422 Unprocessable Entity

{
  "error": "El dominio phrasso.com no está verificado. Registra el dominio o envía allow_unauthenticated: true para verificar el correo por magic link.",
  "code": "DOMAIN_NOT_VERIFIED",
  "error_code": "DOMAIN_NOT_VERIFIED",
  "domain": "phrasso.com",
  "verification_status": "pending"
}

verification_status viene en null cuando el dominio ni siquiera está registrado. Con allow_unauthenticated: true se envía un correo de verificación a la dirección y el remitente nace con sender_source: "magic_link", domain_authenticated: false y email_verified: false hasta que el destinatario hace clic.

La exigencia del dominio verificado es solo de este endpoint. POST /domains/verify-email y el resto de /domains/*, que se llaman con la API key del cliente, funcionan igual que siempre: no piden el flag ni devuelven DOMAIN_NOT_VERIFIED.

El magic link es la excepción, no el atajo. Verifica la casilla, no el dominio: SES firma con d=amazonses.com, así que el DKIM nunca queda alineado con el dominio del cliente. Úsalo solo cuando el cliente no controla su DNS, y nunca para volumen. Ver Antes de enviar volumen.

POST /v1/partner/projects/{projectId}/api-key/rotate

Rota la API key del proyecto-cliente.

cURL

curl -X POST https://api.reallyquickemails.com/v1/partner/projects/c22e3647-0e4b-4d71-99e2-651dbbac3eb2/api-key/rotate \
  -H "Authorization: Bearer sk_partner_xxxxxxxxxxxx"

Respuesta 200 OK

{
  "project_id": "c22e3647-0e4b-4d71-99e2-651dbbac3eb2",
  "api_key": "sk_proj_yyyyyyyyyyyyyyyyyyyyyyyy",
  "rotated_at": "2026-07-24T09:12:00.000Z",
  "message": "La API key anterior dejó de funcionar."
}

No hay periodo de gracia: la key anterior deja de autenticar en la misma transacción. El proyecto no guarda la key previa, así que no hay ventana de solapamiento. Despliega la nueva antes de que ese cliente vuelva a llamar, o sus requests van a fallar con 401 hasta que lo hagas.

GET /v1/partner/projects/{projectId}/stats

Métricas de envío del cliente: entregas, rebotes, aperturas y clicks.

curl https://api.reallyquickemails.com/v1/partner/projects/c22e3647-0e4b-4d71-99e2-651dbbac3eb2/stats \
  -H "Authorization: Bearer sk_partner_xxxxxxxxxxxx"

GET /v1/partner/whoami

Datos de la organización asociada a tu partner-key, con un bloque partner que trae tu cupo de proyectos. Es la forma de saber cuántos tenants te quedan antes de chocar con MAX_PROJECTS_REACHED.

curl https://api.reallyquickemails.com/v1/partner/whoami \
  -H "Authorization: Bearer sk_partner_xxxxxxxxxxxx"

Respuesta 200 OK

{
  "partner": {
    "id": "61c3a18d-1f2e-4a3b-8c9d-0e1f2a3b4c5d",
    "name": "Nexor",
    "status": "active",
    "max_projects": 200,
    "root_project_id": "d33f4758-1f5c-4e82-a0f3-762ecc4dfc31"
  }
}

max_projects en null significa sin límite. El conteo son los clientes activos, sin contar tu proyecto raíz.

Antes de enviar volumen

Registra el dominio del cliente antes del primer envío grande. No es una recomendación de higiene: es la diferencia entre llegar a la bandeja y no llegar. Un remitente verificado solo por correo (magic link) sale firmado con el dominio compartido de la plataforma. El resultado, medido en clientes reales:

Microsoft rechaza con 5.7.515. Ve SPF=Pass, DKIM=Pass, DMARC=Fail porque nada está alineado con el dominio del From, y a remitentes con volumen los corta ahí mismo.
Gmail responde 550-5.7.1 "likely unsolicited mail". Sin DKIM propio, la reputación del cliente se mezcla con la de todos los demás que envían sin autenticar.
No hay reply domain ni tracking domain. Ambos cuelgan del dominio verificado.

Nada de esto aparece como error en tu integración: la API responde 200, el correo “se envía” y el problema se ve semanas después en la tasa de rebote.

Crea el cliente con su dominio

POST /v1/partner/projects con domain y sender. El pack DNS viene en la respuesta.

Reenvía el verification_url

Es una página pública con los registros y un botón de verificar. Es lo único que tu cliente final necesita abrir, sin cuenta RQE. Si su proveedor de DNS soporta Domain Connect, la publicación es de un clic.

Espera domain.verified

Llega por webhook. Recién ahí habilita el envío de volumen de ese cliente.

Vigila la salud

GET /v1/partner/projects/{projectId} trae health. Un cliente en critical con can_send: true está quemando reputación en silencio.

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.

Errores

Todas las respuestas de error tienen la misma forma:

{
  "error": "Mensaje legible.",
  "code": "MAX_PROJECTS_REACHED",
  "error_code": "MAX_PROJECTS_REACHED"
}

code y error_code llevan siempre el mismo valor. error_code es el canónico; code está por compatibilidad con integraciones existentes. Algunos errores suman campos extra al cuerpo, planos, para que no tengas que parsear el texto.

Códigos de error

Código	`error_code`	Descripción
`400`	`MISSING_NAME`	Falta `name` al crear el proyecto.
`400`	`INVALID_EXTERNAL_KEY`	`external_key` supera los 200 caracteres.
`400`	`INVALID_WEBHOOK_URL`	`webhook_url` no es una URL válida o no usa HTTPS.
`400`	`INVALID_TIMEZONE`	`timezone` no es una zona horaria IANA válida.
`400`	`INVALID_COUNTRY`	`country` no es un código de país válido.
`400`	`EMPTY_PATCH`	El `PATCH` no trae ningún campo reconocido.
`400`	`MISSING_DOMAIN`	Falta `domain` al registrar un dominio.
`400`	`INVALID_DOMAIN`	El dominio tiene formato inválido.
`400`	`INVALID_SENDER`	`sender` no es un objeto con `name` y `email`.
`400`	`MISSING_SENDER_NAME`	Falta el nombre del remitente.
`400`	`INVALID_SENDER_EMAIL`	La dirección del remitente tiene formato inválido.
`400`	`SENDER_REQUIRED_FOR_DOMAIN`	Mandaste `domain` sin `sender`. Van juntos.
`400`	`DOMAIN_REQUIRED_FOR_SENDER`	Mandaste `sender` sin `domain`. Van juntos.
`400`	`SENDER_DOMAIN_MISMATCH`	El correo del remitente no termina en el dominio que registras.
`401`	—	Partner-key ausente o inválida.
`404`	`NOT_FOUND`	El proyecto no existe en tu organización. Un `projectId` malformado y uno de otro partner responden igual.
`404`	`DOMAIN_NOT_FOUND`	El dominio no existe en ese proyecto.
`409`	`MAX_PROJECTS_REACHED`	Alcanzaste tu cupo. Trae `max_projects` y `active_projects` en el cuerpo.
`409`	`PROJECT_DISABLED`	El `external_key` del alta corresponde a un cliente deshabilitado. Trae `project_id`.
`409`	`DOMAIN_SENDER_CONFLICT`	El dominio ya está asociado a otro remitente verificado.
`422`	`DOMAIN_NOT_VERIFIED`	El remitente exige dominio verificado. Trae `domain` y `verification_status`.
`500`	`NO_OWNER`	Tu organización de partner no tiene owner.
`500`	`CREATE_FAILED`	Error interno al crear el proyecto.

PROJECT_DISABLED sale únicamente en el alta, cuando reutilizas el external_key de un cliente deshabilitado. Trae el project_id para que sepas a cuál llamar /reactivate. Un PATCH sobre un cliente deshabilitado sí funciona, a propósito: así puedes dejarle bien el webhook antes de reactivarlo.

Partner quickstart — los dos modelos de integración y cuándo conviene cada uno.
Dominios — la misma gestión con la API key del cliente.
Webhooks — domain.verified, sender.verified y eventos de email.
API pública — envío con la key del cliente.

Guías

La app

Conceptos

API Reference

Autenticación

Alta completa en una llamada

POST /v1/partner/projects

Request Body

Ejemplo mínimo — solo el proyecto

Ejemplo — alta completa

El pack DNS

Idempotencia

Alta parcial

GET /v1/partner/projects

GET /v1/partner/projects/{projectId}

El bloque `health`

PATCH /v1/partner/projects/{projectId}

Request Body

DELETE /v1/partner/projects/{projectId}

POST /v1/partner/projects/{projectId}/reactivate

Dominios del cliente

POST /v1/partner/projects/{projectId}/domains

Pasos omitidos

GET /v1/partner/projects/{projectId}/domains

GET /v1/partner/projects/{projectId}/domains/{domain}

POST /v1/partner/projects/{projectId}/domains/{domain}/verify

Remitentes del cliente

GET /v1/partner/projects/{projectId}/senders

POST /v1/partner/projects/{projectId}/senders

POST /v1/partner/projects/{projectId}/api-key/rotate

GET /v1/partner/projects/{projectId}/stats

GET /v1/partner/whoami

Antes de enviar volumen

Errores

Códigos de error

Siguiente

​Autenticación

​Alta completa en una llamada

​POST /v1/partner/projects

​Request Body

​Ejemplo mínimo — solo el proyecto

​Ejemplo — alta completa

​El pack DNS

​Idempotencia

​Alta parcial

​GET /v1/partner/projects

​GET /v1/partner/projects/{projectId}

​El bloque health

​PATCH /v1/partner/projects/{projectId}

​Request Body

​DELETE /v1/partner/projects/{projectId}

​POST /v1/partner/projects/{projectId}/reactivate

​Dominios del cliente

​POST /v1/partner/projects/{projectId}/domains

​Pasos omitidos

​GET /v1/partner/projects/{projectId}/domains

​GET /v1/partner/projects/{projectId}/domains/{domain}

​POST /v1/partner/projects/{projectId}/domains/{domain}/verify

​Remitentes del cliente

​GET /v1/partner/projects/{projectId}/senders

​POST /v1/partner/projects/{projectId}/senders

​POST /v1/partner/projects/{projectId}/api-key/rotate

​GET /v1/partner/projects/{projectId}/stats

​GET /v1/partner/whoami

​Antes de enviar volumen

​Errores

​Códigos de error

​Siguiente

Autenticación

Alta completa en una llamada

POST /v1/partner/projects

Request Body

Ejemplo mínimo — solo el proyecto

Ejemplo — alta completa

El pack DNS

Idempotencia

Alta parcial

GET /v1/partner/projects

GET /v1/partner/projects/{projectId}

El bloque `health`

PATCH /v1/partner/projects/{projectId}

Request Body

DELETE /v1/partner/projects/{projectId}

POST /v1/partner/projects/{projectId}/reactivate

Dominios del cliente

POST /v1/partner/projects/{projectId}/domains

Pasos omitidos

GET /v1/partner/projects/{projectId}/domains

GET /v1/partner/projects/{projectId}/domains/{domain}

POST /v1/partner/projects/{projectId}/domains/{domain}/verify

Remitentes del cliente

GET /v1/partner/projects/{projectId}/senders

POST /v1/partner/projects/{projectId}/senders

POST /v1/partner/projects/{projectId}/api-key/rotate

GET /v1/partner/projects/{projectId}/stats

GET /v1/partner/whoami

Antes de enviar volumen

Errores

Códigos de error

Siguiente