Updates settings for a specific domain.
Hosted Services: Enable hosted DMARC or MTA-STS to have DNS records managed by our system. When enabled, the response includes CNAME records you must add to your DNS.
hosted_dmarc: Enable hosted DMARC (requires paid plan)hosted_mta_sts: Enable hosted MTA-STS (requires paid plan and mta_sts_report enabled)hosted_dmarc_config: Custom DMARC record (optional)DMARC Record: When you enable hosted DMARC, we generate a default record for you. The response includes default_dmarc_record and current_dmarc_config fields. If you want to customize the record (policy, sp, pct, etc.), provide hosted_dmarc_config but keep the RUA and RUF addresses from the default record - these are required to receive reports.
Parked Domain Restrictions: - Hosted MTA-STS is not available for parked domains - Hosted DMARC for parked domains requires p=reject policy - Subdomain policy (sp) must also be reject for parked domains
After adding the CNAME records, use the verify endpoints to check propagation.
| Code | Description |
|---|---|
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 500 | Server crashed for some reason |
| Param name | Description |
|---|---|
|
domain required |
Validations:
|
|
domain[rua_report] optional |
Receives RUA Report against your domain Validations:
|
|
domain[ruf_report] optional |
Receives RUF Report against your domain Validations:
|
|
domain[mta_sts_report] optional |
Receives MTA-STS Report against your domain Validations:
|
|
domain[hosted_dmarc] optional |
Enable hosted DMARC - DNS records managed by our system (requires paid plan) Validations:
|
|
domain[hosted_dmarc_config] optional |
Custom DMARC record. Must include RUA and RUF addresses from default_dmarc_record to receive reports. Validations:
|
|
domain[hosted_mta_sts] optional |
Enable hosted MTA-STS - DNS records managed by our system (requires paid plan and mta_sts_report) Validations:
|