---
title: Dominios
description: Verifica un dominio de envío, añade sus registros DNS y configúralo para el rastreo, la recepción y el calentamiento.
seo:
  title: Configurar un dominio de envío
ai:
  exclude: true
---

Todo email debe enviarse desde un dominio que tu equipo haya verificado. Cualquier otra dirección en `from` se rechaza con `422`. Añade y verifica dominios en el panel, en **Dominios**, o con la API.

## Añadir y verificar un dominio

```bash
curl -X POST https://api.billionsend.com/domains \
  -H "Authorization: Bearer $BILLIONSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "mail.example.com" }'
```

La respuesta lista los registros DNS que debes añadir en tu proveedor de DNS. Un subdominio como `mail.example.com` es una buena opción para un dominio de envío. Cuando los registros estén activos, pulsa **Verificar** en la página del dominio o llama a `POST /domains/{id}/verify`.

| Registro | Para qué sirve |
| --- | --- |
| DKIM (dos CNAME, `bs1._domainkey` y `bs2._domainkey`) | Firma tu correo para que los proveedores sepan que es tuyo. |
| MAIL FROM (MX y TXT) | Una dirección de rebote en tu propio dominio, para que SPF se alinee. |
| DMARC (TXT, recomendado) | Indica a los proveedores qué hacer con el correo que no pasa las comprobaciones. No bloquea el envío. |

DKIM y MAIL FROM deben estar verificados antes de que puedas enviar. En Cloudflare, mantén estos registros en **Solo DNS** (nube gris).

La página del dominio muestra cada registro como encontrado, ausente o con valor distinto, comprobado en directo contra el DNS público. `GET /domains/{id}` devuelve lo mismo en `records[]`. Cada registro tiene un `status` (`not_started`, `pending`, `verified` o `failed`), un valor `live` con lo que responde ahora el DNS público y un `detail` breve cuando algo va mal.

### Las claves DKIM rotan solas

BillionSend crea una clave DKIM para cada dominio y la sustituye cada 180 días, alternando entre los dos CNAME. Añades los registros una vez y no vuelves a tocarlos. Puedes desactivar la rotación automática en la pestaña **Configuración** del dominio.

### Región

`POST /domains` acepta un `region` opcional. Un dominio vive en una sola región. Para moverlo, elimínalo y vuelve a añadirlo en la otra región; sus registros DNS cambian.

### Límites del plan

| | Free | Starter | Pro y Scale |
| --- | --- | --- | --- |
| Dominios de envío por equipo | 3 | 10 | Ilimitados |

Al pasar el límite, `POST /domains` responde `403 plan_limit_reached`. Un nombre de dominio que ya tiene otro equipo responde `409`.

## Calentamiento de un dominio nuevo

Un dominio recién registrado envía un volumen diario limitado mientras construye su reputación. El tope depende de la antigüedad del dominio registrado (`example.com` para `mail.example.com`) y se cuenta por día UTC:

| Antigüedad del dominio | Emails por día |
| --- | --- |
| Menos de 1 día | 100 |
| De 1 a menos de 7 días | 300 |
| De 7 a menos de 30 días | 2000 |
| 30 días o más | Solo el límite de tu plan |

- Un dominio que envía bien, con pocos rebotes y sin quejas, sube de escalón antes.
- El tope se aplica además de tu plan. Mejorar de plan no lo levanta.
- Tus dominios nuevos comparten un único volumen diario: añadir otro dominio nuevo no suma volumen.
- El correo que supera el tope no se pierde. Aparece como **En espera** y sale al día siguiente, empezando por el más antiguo. Si ya hay mucho correo en espera, un envío responde `429 daily_quota_exceeded`; reintenta cuando cambie el día UTC.

La página del dominio muestra «Calentando: N/día hoy» mientras se aplica un tope. Consulta [Límites de envío](/docs/es/concepts/sending-limits) para ver todas las protecciones del envío.

## Configuración

Una vez verificado el dominio, tienes disponibles estos ajustes:

- **Seguimiento de aperturas y clics.** Ambos están desactivados por defecto. Actívalos en la pestaña **Enlaces** del dominio, o con `open_tracking` y `click_tracking` en `PATCH /domains/{id}`. Consulta [Rastreo](/docs/es/concepts/tracking).
- **Subdominios propios de rastreo y de baja.** Sirve los enlaces rastreados y los enlaces de baja desde tu propio dominio. Requiere un plan de pago. Consulta [Rastreo](/docs/es/concepts/tracking).
- **Página de baja.** El aspecto de la página que ven tus destinatarios: nombre, logo, colores y textos. Defínelo en la pestaña **Marca** del dominio, o con `unsubscribe_page` en `PATCH /domains/{id}`. Consulta [Bajas](/docs/es/concepts/unsubscribes).
- **TLS obligatorio.** Entrega solo a servidores que admiten TLS. Defínelo en la pestaña **Configuración**.
- **Nombre del remitente, dirección del remitente y reply-to por defecto.** Defínelos en la pestaña **Configuración**.

## Recepción

Un dominio verificado también puede [recibir correo](/docs/es/receiving). Actívalo con **Activar la recepción** en la página del dominio, o con `PATCH /domains/{id}`:

```json
{ "capabilities": { "receiving": "enabled" } }
```

- Solo un dominio verificado puede activar la recepción. `POST /domains` con `"receiving": "enabled"` responde `422`: añade el dominio, verifícalo y después activa la recepción.
- Al activarla se añaden dos registros de `Recepción`: registros MX que apuntan a `mx1.billionsend-dns.com` y `mx2.billionsend-dns.com`, ambos con prioridad `10`. Publica los dos, para que un remitente que encuentre uno caído reintente con el otro. No afectan al envío. Si el dominio ya recibe correo en otro sitio, pon los registros MX en un subdominio como `inbound.example.com`, porque un registro MX con número más bajo se quedaría con el correo.
- Un nombre solo puede recibir en un equipo. Un nombre en el que ya recibe otro equipo responde `409`.
- Por defecto solo reciben correo las direcciones de tus [bandejas de entrada](/docs/es/inboxes). **Catch-all** acepta todas las direcciones del dominio. Requiere un plan de pago y se activa en el panel o con `receiving_catch_all` en `PATCH /domains/{id}`.

## Subdominio compartido

Cada equipo recibe también un subdominio en un dominio compartido de BillionSend, donde sus [bandejas de entrada](/docs/es/inboxes) compartidas obtienen sus direcciones. Aparece al final de `GET /domains` con `shared: true`. Ya está verificado y es de solo lectura: `PATCH`, verificar y `DELETE` responden `403 forbidden`, y no cuenta para el límite de dominios. Solo puede enviar desde las direcciones propias de tus bandejas de entrada.

## Eliminar un dominio

`DELETE /domains/{id}`, o **Eliminar** en la página del dominio, se rechaza con `409` en dos casos:

- Un [tema](/docs/es/concepts/topics) o [segmento](/docs/es/concepts/segments) está ligado al dominio. Elimínalo, o pon su `domain_id` en `null`.
- Un [envío masivo](/docs/es/concepts/broadcasts) programado o en curso usa el dominio. Cancélalo, o espera a que termine de salir.

Eliminar un dominio también elimina sus bandejas de entrada. Las [bajas](/docs/es/concepts/unsubscribes) de los destinatarios de ese dominio se conservan, y vuelven a aplicarse si añades de nuevo el mismo nombre.

## Claves de API y dominios

Una clave de API se puede limitar a un dominio. Esa clave solo puede enviar desde ese dominio, y cualquier otro `from` responde `403 restricted_api_key`. Solo lee el correo recibido en ese dominio, solo ve y modifica ese dominio en `/domains` (cualquier otro dominio responde `404`), y las claves que crea quedan limitadas al mismo dominio. Los webhooks, las supresiones, las plantillas y el resto de lo que pertenece a todo el equipo responden `403 restricted_api_key`; la página de [claves de API](/docs/es/api-keys) los lista. Una clave también se puede limitar a una [bandeja de entrada](/docs/es/inboxes).
