Dominio

Un Dominio representa un hostname personalizado registrado en una cuenta para branding, entregabilidad de email y configuración TLS.

Schema

interface Domain {
  id: string; // "hst..." - Identificador único
  account_id: string; // Cuenta propietaria
  hostname: string; // Nombre de dominio
  client_id: string | null; // Cliente asociado
  cname_config: { type: "proxy" } | null;
  email_config:
    | { type: "catch-all" }
    | { type: "forward"; forward_to: Record<string, string> }
    | null;
  txt_verification_token: string; // Valor TXT para verificación DNS
}

Propiedades

Propiedad	Tipo	Descripción
`id`	`string`	KSUID con prefijo `hst`
`account_id`	`string`	Cuenta dueña del dominio
`hostname`	`string`	Nombre de dominio (p. ej., `mail.example.com`)
`client_id`	`string?`	Cliente OAuth asociado
`cname_config`	`object?`	Configuración de proxy CNAME
`email_config`	`object?`	Configuración de enrutamiento de correo
`txt_verification_token`	`string`	Token para verificación DNS TXT

Verificación DNS

Agrega un registro TXT para verificar propiedad:

Tipo	Nombre	Valor
TXT	`_am.mail.example.com`	`{txt_verification_token}`

Flujo de Verificación

Ejemplo

{
  "id": "hst_2kHfPZcN9xW4mE8RtY7vB",
  "account_id": "acc_1jGePYbM8wV3lD7QsX6uA",
  "hostname": "mail.example.com",
  "client_id": null,
  "cname_config": { "type": "proxy" },
  "email_config": null,
  "txt_verification_token": "am_2abc123xyz"
}

Relacionado

Clave DKIM - Firma de email
Email - Infraestructura de correo