# 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


## Create tracking domain

 - [POST /api/v1/customer/tracking-domains](https://developers.mailerlogic.com/customer-api.openapi/tracking-domains/paths/~1api~1v1~1customer~1tracking-domains/post.md): 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)

## List tracking domains

 - [GET /api/v1/customer/tracking-domains](https://developers.mailerlogic.com/customer-api.openapi/tracking-domains/paths/~1api~1v1~1customer~1tracking-domains/get.md): Retrieve all tracking domains for your account.

Returns a list of all tracking domains with their verification and SSL status.

## Get tracking domain

 - [GET /api/v1/customer/tracking-domains/{id}](https://developers.mailerlogic.com/customer-api.openapi/tracking-domains/paths/~1api~1v1~1customer~1tracking-domains~1%7Bid%7D/get.md): Retrieve details for a specific tracking domain including DNS setup instructions.

## Update tracking domain

 - [PATCH /api/v1/customer/tracking-domains/{id}](https://developers.mailerlogic.com/customer-api.openapi/tracking-domains/paths/~1api~1v1~1customer~1tracking-domains~1%7Bid%7D/patch.md): Update the domain name for a tracking domain. This will reset verification and SSL status.

Note: Changing the domain name will require re-verification and SSL re-provisioning.

## Delete tracking domain

 - [DELETE /api/v1/customer/tracking-domains/{id}](https://developers.mailerlogic.com/customer-api.openapi/tracking-domains/paths/~1api~1v1~1customer~1tracking-domains~1%7Bid%7D/delete.md): Delete a tracking domain from your account.

Important: You cannot delete a tracking domain that is currently assigned to any sending domains. Remove it from all sending domains first.

## Verify tracking domain DNS

 - [POST /api/v1/customer/tracking-domains/{id}/verify](https://developers.mailerlogic.com/customer-api.openapi/tracking-domains/paths/~1api~1v1~1customer~1tracking-domains~1%7Bid%7D~1verify/post.md): Verify that the CNAME record has been correctly configured for the tracking domain.

Verification Process:
1. Checks that the CNAME record points to the correct target
2. If verified, automatically triggers SSL certificate generation
3. SSL provisioning takes 1-2 minutes after verification

After Verification:
- SSL certificate is automatically provisioned via Let's Encrypt
- You can check SSL status using GET /api/v1/customer/tracking-domains/:id/ssl
- The tracking domain becomes ready to use once SSL is active

Troubleshooting:
- DNS propagation can take 5-30 minutes
- Use dig CNAME track.yourdomain.com to check DNS status
- Ensure CNAME points exactly to the target provided

## Check SSL certificate status

 - [GET /api/v1/customer/tracking-domains/{id}/ssl](https://developers.mailerlogic.com/customer-api.openapi/tracking-domains/paths/~1api~1v1~1customer~1tracking-domains~1%7Bid%7D~1ssl/get.md): Check the SSL certificate provisioning status for a tracking domain.

SSL Certificate Lifecycle:
1. unavailable: Domain not yet verified
2. provisioning: Certificate being generated (1-2 minutes after verification)
3. active: Certificate issued and working

Certificate Details:
- Issued by Let's Encrypt
- Automatically renewed before expiration
- 90-day validity with auto-renewal at 60 days

## Provision SSL certificate

 - [POST /api/v1/customer/tracking-domains/{id}/ssl](https://developers.mailerlogic.com/customer-api.openapi/tracking-domains/paths/~1api~1v1~1customer~1tracking-domains~1%7Bid%7D~1ssl/post.md): Manually trigger SSL certificate provisioning for a verified tracking domain.

When to use this:
- SSL was not automatically provisioned after verification
- You want to force certificate regeneration
- Previous SSL provisioning failed

Note: SSL is automatically provisioned after verification in most cases, so you typically don't need to call this endpoint.

Process:
- Request returns immediately with 202 Accepted
- Certificate generation happens in background (30-60 seconds)
- Check status with GET /api/v1/customer/tracking-domains/:id/ssl