POST https://api.dmarcreport.com/v2/accounts/:account_id/domains/:id/generate_dmarc_record.json
Generate a DMARC record

Generates a DMARC record for your domain with all the options available in our UI. Our reporting addresses (RUA and RUF) are automatically included.

Standard DMARC Options: - p (policy): How to handle emails that fail DMARC (none, quarantine, reject) - sp (subdomain policy): Policy for subdomains (none, quarantine, reject) - pct (percentage): Percentage of emails to apply the policy to (0-100) - adkim (DKIM alignment): How strictly to check DKIM (r=relaxed, s=strict) - aspf (SPF alignment): How strictly to check SPF (r=relaxed, s=strict) - fo (forensic options): When to send forensic reports (0, 1, d, s - can combine with colon) - additional_rua_emails (array): Additional email addresses for aggregate reports - additional_ruf_emails (array): Additional email addresses for forensic reports

DMARCbis Options (newer standard): - t (test mode): Enable test mode - reports only, no policy enforcement (y, n) - psd (public suffix domain): Is this a public suffix domain? (y, n, u=unknown) - np (non-existent subdomain policy): Policy for non-existent subdomains (none, quarantine, reject)

Forensic Options (fo) explained: - 0: Send report if all authentication fails (default) - 1: Send report if any authentication fails - d: Send report if DKIM fails - s: Send report if SPF fails - Combine with colon, e.g., “1:d:s” for multiple options

Supported Formats

JSON

Errors

Code Description
401 Unauthorized
403 Forbidden
404 Not Found
500 Server crashed for some reason

Params

Param name Description
p
required

Policy: none (monitor), quarantine (spam folder), reject (block)

Validations:

  • Must be one of: none, quarantine, reject.
sp
optional

Subdomain policy (optional)

Validations:

  • Must be one of: none, quarantine, reject.
pct
optional

Percentage of emails to apply policy (0-100)

Validations:

  • Must be a Integer
adkim
optional

DKIM alignment: r=relaxed (default), s=strict

Validations:

  • Must be one of: r, s.
aspf
optional

SPF alignment: r=relaxed (default), s=strict

Validations:

  • Must be one of: r, s.
fo
optional

Forensic options: 0, 1, d, s (combine with colon, e.g., “1:d”)

Validations:

  • Must be a String
additional_rua_emails
optional

Additional aggregate report email addresses

Validations:

  • Must be an array of any type
additional_ruf_emails
optional

Additional forensic report email addresses

Validations:

  • Must be an array of any type
t
optional

DMARCbis: Test mode (y=yes, n=no)

Validations:

  • Must be one of: y, n.
psd
optional

DMARCbis: Public suffix domain (y=yes, n=no, u=unknown)

Validations:

  • Must be one of: y, n, u.
np
optional

DMARCbis: Non-existent subdomain policy

Validations:

  • Must be one of: none, quarantine, reject.
publish
optional

Also publish this record to hosted DMARC (requires hosted_dmarc enabled)

Validations:

  • Must be one of: true, false, true, false.