Skip to content

Tracking Domains

Manage custom tracking domains for branded click and open tracking. Tracking domains allow you to use your own domain (e.g., track.yourdomain.com) instead of the default mailerlogic.net domain for tracking links and pixels.

Setup workflow:

  1. Create tracking domain
  2. Add CNAME record to DNS
  3. Verify DNS configuration
  4. SSL automatically provisions (1-2 minutes)
  5. Assign to sending domains
Operations

Create tracking domain

Request

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)
Security
ApiKeyAuth
Bodyapplication/jsonrequired
domainstringrequired

The tracking domain (subdomain recommended)

Example:"track.yourdomain.com"
curl -i -X POST \
  https://api.mailerlogic.net/api/v1/customer/tracking-domains \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY_HERE' \
  -d '{
    "domain": "track.yourdomain.com"
  }'

Responses

Tracking domain created successfully

Bodyapplication/json
idstring, (uuid)

Tracking domain ID

domainstring

The tracking domain

cname_targetstring

CNAME target for DNS configuration

is_verifiedboolean

Verification status

ssl_enabledboolean

SSL certificate status

created_atstring, (date-time)

Creation timestamp

dns_setupobject
Response
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "domain": "track.yourdomain.com",
  "cname_target": "track.mailerlogic.net",
  "is_verified": false,
  "ssl_enabled": false,
  "created_at": "2026-01-23T10:00:00.000Z",
  "dns_setup": {
    "record_type": "CNAME",
    "hostname": "track.yourdomain.com",
    "value": "track.mailerlogic.net",
    "instructions": "Add a CNAME record in your DNS settings pointing track.yourdomain.com to track.mailerlogic.net"
  }
}