Domain

Enable hosted DMARC

Rebuilds the Palisade-hosted DMARC record from the domain's current policy, publishes it, and returns the CNAME to point _dmarc at. Call this before showing anyone the CNAME: the delegation target is otherwise whatever was written when the domain was created, so a domain whose owner tightened their own DMARC policy since then would be switched onto a weaker one. Nothing is written to the database unless the publish succeeds, so a failure is safe to retry, and calling it on a domain that is already hosted changes nothing and answers hosted_dmarc_active: true.

post/domains/{id}/hosted-dmarc

Request

  • Base URL: https://api.palisade.email
  • URL: https://api.palisade.email/domains/{id}/hosted-dmarc
  • Auth: one of:
    • HTTP bearer
    • HTTP basic

Path parameters

idstring uuid required

Headers

Palisade-Version'2025-04-30' | 'unstable' required

Response

Success

hosted_dmarc_activeboolean required

False until the hosted CNAME resolves in live DNS. Publish "record" and Palisade flips this to true on its own; true already on a domain that was hosted before the call.

Example response

{
  "domain": {
    "monitoring_since": "2025-09-14"
  }
}

Changes

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