# Sending Domains

Add and verify domains for sending authenticated emails.
Configure SPF, DKIM, and DMARC records to improve deliverability.


## List all domains

 - [GET /api/v1/customer/domains](https://developers.mailerlogic.com/customer-api.openapi/sending-domains/paths/~1api~1v1~1customer~1domains/get.md): Retrieve all domains registered to your account with their verification status.
Use this to check which domains are ready for sending emails.

## Add domain

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

## Get required DNS records

 - [GET /api/v1/customer/domains/{id}/dns](https://developers.mailerlogic.com/customer-api.openapi/sending-domains/paths/~1api~1v1~1customer~1domains~1%7Bid%7D~1dns/get.md): Get the DNS records you need to configure for this domain.
Add these TXT records to your DNS provider to verify ownership and enable email authentication (SPF, DKIM, DMARC).

## Verify domain

 - [POST /api/v1/customer/domains/{id}/verify](https://developers.mailerlogic.com/customer-api.openapi/sending-domains/paths/~1api~1v1~1customer~1domains~1%7Bid%7D~1verify/post.md): Verify DNS records for the domain. This checks SPF, DKIM, DMARC, and domain verification records.

## Update domain tracking settings

 - [PATCH /api/v1/customer/domains/{id}](https://developers.mailerlogic.com/customer-api.openapi/sending-domains/paths/~1api~1v1~1customer~1domains~1%7Bid%7D/patch.md): Configure per-domain tracking settings. Override global customer defaults for this specific domain.

Tracking Hierarchy (highest to lowest priority):
1. Per-email override (in send request)
2. Per-domain settings (this endpoint)
3. Customer global defaults

Settings:
- tracking_enabled - Master toggle for all tracking (NULL = use customer default)
- open_tracking_enabled - Track email opens (NULL = use customer default)
- click_tracking_enabled - Track link clicks (NULL = use customer default)
- unsubscribe_header_enabled - Include List-Unsubscribe header (NULL = use customer default)

NULL Values: Set to null to inherit from customer global settings. Set to true or false to override.

Use Cases:
- Disable tracking for transactional domains
- Enable tracking only for marketing domains
- Client-specific requirements
- Environment-based (test vs production)

## Delete domain

 - [DELETE /api/v1/customer/domains/{id}](https://developers.mailerlogic.com/customer-api.openapi/sending-domains/paths/~1api~1v1~1customer~1domains~1%7Bid%7D/delete.md): Remove a domain from the account. This cannot be undone.

## Check domain test readiness

 - [GET /api/v1/customer/domains/test-readiness/{domain_id}](https://developers.mailerlogic.com/customer-api.openapi/sending-domains/paths/~1api~1v1~1customer~1domains~1test-readiness~1%7Bdomain_id%7D/get.md): Check if a domain is ready for sending test emails and get recommendations for test mode.

Purpose:
This endpoint helps you determine the best approach for testing new domains to avoid spam filters.

Returns:
- Domain age and health score
- Historical sending statistics
- Custom tracking domain status
- Recommended test mode (basic/standard/full)
- Warnings and actionable recommendations
- Readiness checklist

Test Modes:
- Basic: Plain text only, no tracking, no links. Best for new domains  30 days.

Use Case:
Call this endpoint before displaying the test email form to show warnings and auto-configure tracking based on domain health.