Skip to content

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"
  }
}