Skip to main content

Configuring DMARC Policy via API

Updated over 2 weeks ago

The DMARC Configuration API helps businesses manage domains and subdomains, automate DMARC posture and policy rollouts, and centrally administer email security configuration at scale, including sender integrations, netblock visibility for SPF alignment, and transport security controls like MTA-STS and TLS-RPT, improving security and deliverability, streamlining operations, increasing monitoring and reporting visibility, and supporting compliance and governance requirements.

General Use Cases


1. Automated Domain Management

  • Scenario: Customers use domain endpoints to add/update domain records programmatically.

  • Outcome: Simplifies multi-domain management.

2. Centralized Subdomain Policy Management

  • Scenario: A customer centrally manages subdomain DMARC coverage (e.g., enabling/disabling subdomain monitoring or applying consistent policy inheritance) by updating subdomain-related settings within the Configuration API for a parent domain.

  • Outcome: Consistent enforcement and visibility across subdomains with reduced manual configuration drift.

3. Subdomain Coverage Audit and Baseline Enforcement

  • Scenario: A customer audits subdomain configurations to identify which subdomains are missing required email authentication controls, then programmatically applies the approved configuration baseline.

  • Outcome: Faster remediation of gaps and improved overall domain posture at scale.

4. Proactive Security Improvements

  • Scenario: Identify domains with weak policies and strengthen DMARC posture.

  • Outcome: Reduced risk of phishing and spoofing.

5. Managing Sender Integrations Programmatically

  • Scenario: Link third-party email services (SendGrid, Mailgun, etc.) to domains.

  • Outcome: Streamlined setup and onboarding.

6. Visualizing Netblock Coverage

  • Scenario: Pull netblocks to validate SPF coverage across legitimate mail sources.

  • Outcome: Reduced false positives and improved authentication alignment.

7. Programmatic MTA-STS Enablement and Updates

  • Scenario: A customer publishes or updates MTA-STS policy settings for one or more domains through the Configuration API as part of a standardized “secure email” rollout.

  • Outcome: Improved transport security by enforcing TLS requirements for inbound mail delivery.

8. Staged MTA-STS Policy Version Rollout

  • Scenario: A customer rotates MTA-STS policy versions and validates changes during staged deployments (dev → pilot → production) using API-driven updates rather than manual DNS/web hosting changes.

  • Outcome: Safer rollouts with fewer misconfigurations and clearer change control.

9. TLS-RPT Activation and Report Destination Configuration

  • Scenario: A customer enables TLS-RPT reporting for domains and configures the reporting destination(s) using the Configuration API to receive automated feedback on TLS negotiation failures.

  • Outcome: Increased visibility into delivery issues and misconfigurations impacting encrypted transport.

10. Fleetwide TLS-RPT Standardization

  • Scenario: A customer periodically reviews TLS-RPT configuration state across many domains, then standardizes reporting URIs and settings to ensure consistent telemetry.

  • Outcome: Reliable, account-wide transport reporting with simplified operational oversight.

11. Automated User Lifecycle Provisioning

  • Scenario: A customer uses SCIM-based user and group provisioning to automatically create, update, and deactivate users in Valimail when changes occur in their identity provider (e.g., Okta, Azure AD).

  • Outcome: Reduced administrative workload and improved security through timely deprovisioning and least-privilege access.

12. Group-Based Access and Role Synchronization

  • Scenario: A customer synchronizes role-based access by mapping identity provider groups to application permissions, ensuring the correct teams have access to the correct accounts and domains.

  • Outcome: More consistent access control with fewer manual errors and faster onboarding/offboarding.

Detailed Business Use Cases

1. Domain Management and Automation

Automating Domain Management for Multi-Domain Enterprises

  • Use Case: The DMARC Configuration API facilitates seamless domain management by automating domain record additions and updates across large domain portfolios.

  • Outcome: Reduced operational overhead, improved efficiency, and accelerated compliance with email security standards.

Centralized Management of Domain Records for MSPs

  • Use Case: Managed Service Providers (MSPs) use the API to centrally manage DMARC records and email authentication configurations for multiple customer domains, using bulk updates to streamline administration.

  • Outcome: Enhanced operational efficiency, improved compliance, and simplified management across customer accounts.

Centralized Subdomain Policy Management

  • Use Case: Customers centrally manage subdomain DMARC coverage by updating subdomain-related settings for a parent domain (e.g., enabling/disabling subdomain monitoring or enforcing consistent inheritance/overrides).

  • Outcome: Consistent enforcement and visibility across subdomains with reduced manual configuration drift.

Subdomain Coverage Audit and Baseline Enforcement

  • Use Case: Customers audit subdomain configuration state at scale to identify gaps (e.g., missing required controls), then programmatically apply an approved configuration baseline across subdomains.

  • Outcome: Faster remediation of gaps and improved overall domain posture at scale.

2. Proactive Security and Compliance

Identifying Non-Compliant Domains

  • Use Case: The API identifies domains with weak or non-existent DMARC policies (e.g., set to “None”), enabling partners or customers to take proactive steps to strengthen posture.

  • Outcome: Reduced risk of phishing, spoofing, and other email-based threats, with stronger email authentication practices.

Configuring DMARC Policies for New Domains

  • Use Case: Businesses programmatically update DMARC policies during onboarding, progressing from “None” to “Quarantine” or “Reject” as domains move toward full enforcement.

  • Outcome: Seamless domain onboarding, improved email security, and uninterrupted email operations.

Tracking Enforcement Status for Compliance Reporting

  • Use Case: Businesses track the enforcement status of all domains in a customer’s account and generate compliance reports for regulators, auditors, or internal stakeholders.

  • Outcome: Transparency, accountability, and adherence to contractual obligations and regulatory compliance standards.

Domain Prioritization for Security Improvements

  • Use Case: The API retrieves domain sending statuses (e.g., “Active” vs. “Blocked”) and last report dates, enabling prioritization of security improvements for actively used domains first.

  • Outcome: Enhanced security and deliverability by focusing efforts on high-impact domains and reducing vulnerabilities.

Empowering Tiered Security for Customer Accounts

  • Use Case: Businesses implement a tiered security strategy by progressively transitioning domains to stricter DMARC policies, starting with less restrictive settings to reduce disruption.

  • Outcome: Stronger email security adoption that aligns with best practices while maintaining operational stability.

3. Error Detection and Monitoring

Enabling Smart Alerts for Configuration Errors

  • Use Case: Integrating the API with monitoring tools enables businesses to detect and alert customers about configuration issues, such as missing or misconfigured DMARC, SPF, or DKIM records.

  • Outcome: Faster resolution of issues, reduced risk of email delivery failures, and improved customer satisfaction.

Visualizing Netblock Coverage

  • Use Case: The API provides netblock (IP range) data associated with each domain, allowing businesses to visualize coverage and confirm SPF includes all legitimate email sources.

  • Outcome: Reduced chances of legitimate emails being flagged as spam due to incomplete SPF configurations.

TLS-RPT Activation and Report Destination Configuration

  • Use Case: Customers enable TLS-RPT and configure reporting destinations to receive automated telemetry on TLS negotiation failures and transport misconfigurations.

  • Outcome: Increased visibility into delivery issues and misconfigurations impacting encrypted transport.

Fleetwide TLS-RPT Standardization

  • Use Case: Customers periodically review TLS-RPT configuration state across many domains and standardize reporting URIs/settings to ensure consistent telemetry and operational workflows.

  • Outcome: Reliable, account-wide transport reporting with simplified oversight and fewer blind spots.

4. Security Strategies and Sender Integrations

Managing Sender Integrations Programmatically

  • Use Case: The API simplifies linking third-party email services (e.g., SendGrid, Mailgun) to a customer’s domain. Programmatic sender connections reduce friction during integration and onboarding.

  • Outcome: Faster onboarding processes, smoother customer transitions, and improved sender authentication.

5. Transport Security (MTA-STS)

Programmatic MTA-STS Enablement and Updates

  • Use Case: Customers publish or update MTA-STS policy settings through the Configuration API as part of a standardized secure email rollout across one or more domains.

  • Outcome: Improved transport security by enforcing TLS requirements for inbound mail delivery.

Staged MTA-STS Policy Version Rollout

  • Use Case: Customers rotate MTA-STS policy versions and validate changes during staged deployments (e.g., dev → pilot → production) using API-driven updates to improve change control.

  • Outcome: Safer rollouts with fewer misconfigurations and clearer operational governance.

6. Identity and Access Automation (SCIM)

Automated User Lifecycle Provisioning (SCIM)

  • Use Case: Customers use SCIM-based provisioning to automatically create, update, and deactivate users in Valimail when changes occur in their identity provider (e.g., Okta, Azure AD).

  • Outcome: Reduced administrative workload and improved security through timely deprovisioning and least-privilege access.

Group-Based Access and Role Synchronization (SCIM)

  • Use Case: Customers synchronize role-based access by mapping identity provider groups to application permissions, ensuring the correct teams have the right access to the right accounts and domains.

  • Outcome: More consistent access control with fewer manual errors and faster onboarding/offboarding.


The DMARC Configuration API is an invaluable tool for businesses looking to strengthen email security, simplify domain management, and improve compliance. By leveraging automation, proactive monitoring, and strategic security measures, businesses can protect their email infrastructure, reduce the risk of email-based threats, and provide a seamless experience for their customers.

Did this answer your question?