# Create tracking domain

Create a new tracking domain for your account. Tracking domains allow you to brand your click and open tracking links with your own domain instead of the default mailerlogic.net domain.

What are tracking domains?

Tracking domains are custom domains used for:
- Click tracking URLs (when recipients click links in your emails)
- Open tracking pixels (when recipients open your emails)

Benefits:
- Professional appearance (e.g., track.yourbrand.com instead of track.mailerlogic.net)
- Improved deliverability (ISPs recognize your brand)
- Better email client compatibility

Setup Process:
1. Create the tracking domain via this API
2. Add the CNAME record to your DNS (returned in response)
3. Wait 5-30 minutes for DNS propagation
4. Verify the tracking domain (POST /api/v1/customer/tracking-domains/:id/verify)
5. SSL certificate is automatically provisioned after verification
6. Assign tracking domain to your sending domains (PATCH /api/v1/customer/domains/:id)

Endpoint: POST /api/v1/customer/tracking-domains
Version: 1.0.0
Security: ApiKeyAuth

## Request fields (application/json):

  - `domain` (string, required)
    The tracking domain (subdomain recommended)
    Example: "track.yourdomain.com"

## Response 201 fields (application/json):

  - `id` (string)
    Tracking domain ID

  - `domain` (string)
    The tracking domain

  - `cname_target` (string)
    CNAME target for DNS configuration

  - `is_verified` (boolean)
    Verification status

  - `ssl_enabled` (boolean)
    SSL certificate status

  - `created_at` (string)
    Creation timestamp

  - `dns_setup` (object)

  - `dns_setup.record_type` (string)
    Example: "CNAME"

  - `dns_setup.hostname` (string)
    The hostname to configure

  - `dns_setup.value` (string)
    The value to point to

  - `dns_setup.instructions` (string)
    Setup instructions

## Response 400 fields (application/json):

  - `error` (string)
    Error code or message

## Response 401 fields (application/json):

  - `error` (string)
    Error code or message

## Response 409 fields (application/json):

  - `error` (string)
    Example: "Domain already exists"

  - `message` (string)
    Example: "This tracking domain is already registered to your account"

## Response 500 fields (application/json):

  - `error` (string)
    Error code or message