Update Domain
Updates DNS domain settings such as custom subdomains and DKIM rotation interval.
Authorizations
API key for authentication
Body
Optional custom tracking subdomain. Omit to leave the current value unchanged. Applies to both manual-DNS and managed-DNS domains.
Optional custom return-path subdomain. Omit to leave the current value unchanged. Applies to both manual-DNS and managed-DNS domains.
Optional custom subscription management subdomain. Omit to leave the current value unchanged. Applies to both manual-DNS and managed-DNS domains.
Optional custom media subdomain. Omit to leave the current value unchanged. Applies to both manual-DNS and managed-DNS domains.
Optional custom DKIM rotation interval in days. Omit to leave the current value unchanged. Only supported for managed DNS domains on eligible plans.
Optional custom DKIM selector for the domain. Omit or send null to leave the current value unchanged; send an empty or whitespace-only string to clear the override and revert to the default selector. The value is trimmed before it is interpreted, so whitespace-only input clears the override just like an empty string.
When provided, it is normalized to lowercase and must be a single DNS label: 1-62 characters using lowercase letters, numbers, and hyphens only, without a leading or trailing hyphen. It cannot be changed once the selector locks after DNS verification or while a DKIM key rotation is in progress.
Note: This parameter is only supported on Platform Partner accounts.
Response
Domain updated successfully
Object type identifier
domain Unique identifier for the domain
When the domain was created
When the domain was last updated
The domain name
Account ID this domain belongs to
DNS records required for domain verification
Whether all required DNS records are properly configured
When DNS records were last checked
Custom tracking subdomain. Null means the account or product default is used. Applies to both manual-DNS and managed-DNS domains.
Custom return-path subdomain. Null means the account or product default is used. Applies to both manual-DNS and managed-DNS domains.
Custom subscription management subdomain. Null means the account or product default is used. Applies to both manual-DNS and managed-DNS domains.
Custom media subdomain. Null means the account or product default is used. Applies to both manual-DNS and managed-DNS domains.
Custom DKIM rotation interval in days. Null means the account default is used. Only supported for managed DNS domains.
Per-domain DKIM selector override. Null means no per-domain override is set.
This reports the configured per-domain override only, not the effective selector used for DKIM signing. The effective selector is resolved separately and can differ — for example, a selector locked after DNS verification takes precedence over this override.
Whether the standby DKIM slot is ready for rotation.
Optional recipient address for delivery status notifications.

