Domains

Add a domain

Add a domain you'll send email from. The response includes the DNS records (SPF, DKIM, and so on) to publish with your DNS provider. Once they're published, trigger a check with Verify a domain — sending from the domain is blocked until it verifies. Requires the domains:write capability.

post/email/domains

Request

  • Base URL: https://www.unitpost.com/api/v1
  • URL: https://www.unitpost.com/api/v1/email/domains
  • Auth: HTTP bearer

Request body

namestring required

Response

Created.

object'domain' required
idstring required
namestring required
status'pending' | 'verifying' | 'verified' | 'degraded' | 'failed' required
dkim_selectorstring nullable required
open_trackingboolean nullable required
click_trackingboolean nullable required
tls'opportunistic' | 'enforced' required
tracking_subdomainstring nullable required
tracking_verified_atstring nullable required

When tracked links and open pixels started using the custom tracking host (tracking_subdomain). Non-null only while sends actually use it: the domain is verified (or degraded) and the host's last check proved it answers over HTTPS. Otherwise null, and links use the default tracking host. A host that stops answering, or a domain that's no longer verified, goes back to null.

verified_atstring nullable required
created_atstring required
updated_atstring required

Changes

No recorded changes to this operation across all 1 revision of this API.