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.
