# Add domain

Register a new domain for sending emails. This will generate DKIM keys and DNS records.
After adding, use the DNS endpoint to get records that need to be configured.

Endpoint: POST /api/customer/domains
Version: 1.0.0
Security: BearerAuth

## Request fields (application/json):

  - `domain` (string, required)
    Fully qualified domain name
    Example: "mail.acme.com"

  - `tags` (array)
    Optional tags for categorization
    Example: ["production","transactional"]

## Response 201 fields (application/json):

  - `domain` (object)

  - `domain.id` (string)

  - `domain.verification_status` (string)
    Enum: "pending", "verified", "failed"

  - `domain.dkim_selector` (string)

  - `domain.spf_record` (string)

  - `domain.dmarc_record` (string)

  - `domain.is_active` (boolean)

  - `domain.tags` (array)

  - `domain.created_at` (string)

  - `domain.verified_at` (any)

  - `domain.verification_token` (string)

  - `domain.dkim_private_key` (string)
    DKIM private key (keep secure!)

  - `domain.dkim_public_key` (string)

## Response 401 fields (application/json):

  - `error` (string)
    Error code or message

## Response 500 fields (application/json):

  - `error` (string)
    Error code or message