Troubleshooting API

When DMARC Blocks Your Mail: Finding and Fixing Failures

Using a strong 'reject' policy is the goal, but it can stop real emails if alignment or sender settings are wrong. Veldica gives you the specific details you need to find out why mail is being blocked and how to fix it without lowering your security.

Use the Pro audit to find exactly where your mail settings are mismatched and get a specific plan to fix them.

Overview

Using a strong 'reject' policy is the goal, but it can stop real emails if alignment or sender settings are wrong. Veldica gives you the specific details you need to find out why mail is being blocked and how to fix it without lowering your security.

The Problem
Sudden Delivery Drop

After turning on strong security, some important emails stop getting through. You need to know why immediately.

The Challenge
Finding the Error

Most reports are delayed by a full day. You need to see your current DNS settings and errors currently.

The Solution
Fast Alignment Audit

Veldica checks your current security settings and finds the exact mismatch that is causing mail to be blocked.

DMARC Debugging Workflow

When your mail is being rejected, follow these steps to find and fix the problem.

  1. Audit: Send the failing domain to the Pro audit API.
  2. Check: Look for "alignment failed" or "missing record" results.
  3. Inspect: See how mail servers are reading your security rules.
  4. Plan: Use the fix-plan to get the exact DNS record you need.
  5. Verify: Audit again after your change to confirm alignment is restored before the next mail batch.

Why Emails Get Blocked

Mail rejections are usually caused by new tools or incomplete setup.

  • New Tools: A department starts using a new email tool that doesn't have your security settings yet.
  • Forwarding: Emails sent through other servers can fail SPF and may need aligned DKIM signing.
  • Slow Updates: Recent DNS changes might not have reached every server yet, causing random failures.
  • Domain Mismatch: Your email tool might be using a different domain name than your main brand.

Real-Time Debugging

Move from waiting for reports to fixing errors as they happen.

Old Logs

Search through reports from yesterday. This is slow and often misses the real problem.

Real-time Audit

Check your domain currently and see the current status of all your email senders.

Clear findings

Find specific issues like 'alignment failed' in easy-to-read reports.

Fast Fix

Use our tools to get concrete DNS guidance for the update.

DMARC Error Search

Use the Pro audit to find out why a domain's mail is being blocked.

Request
curl -H 'content-type: application/json' \
  -H 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  -H 'X-RapidAPI-Host: email-domain-trust-auditor.p.rapidapi.com' \
  -X POST 'https://email-domain-trust-auditor.p.rapidapi.com/v1/pro/audits/domain' \
  -d '{
    "domain": "veldica.com"
  }'

Verified response

Pro audit excerpt

Audit result showing a critical setup error.

{
  "domain": "veldica.com",
  "score": 65,
  "risk": {
    "enforcement_status": "fully_enforced",
    "risk_level": "medium"
  },
  "findings": [
    {
      "id": "dmarc.alignment.failed",
      "check": "dmarc",
      "status": "fail",
      "severity": "critical",
      "title": "DMARC Alignment Failed",
      "evidence": "Your security settings don't match your domain name.",
      "fix": "Update your email tool to use an aligned return-path or DKIM signing domain."
    }
  ],
  "mail_flow_profile": "sender_enforced",
  "mail_flow_note": "Mail servers are told to block your mail if it's not set up correctly."
}
Fix-plan excerpt

Clear steps for getting your mail delivered again.

{
  "domain": "veldica.com",
  "template_remediations": [
    {
      "issue_id": "dmarc.alignment.failed",
      "priority": "p1",
      "dns_name": "veldica.com",
      "operation": "update",
      "proposed_value_template": "Add aligned DKIM signing or update SPF for the sender's return-path domain.",
      "rationale": "DMARC requires SPF or DKIM alignment when p=reject is active."
    }
  ]
}

Reading the Results

Use the findings to fix your email delivery problems.

  • Check Alignment: Look for "alignment failed." This is the most common reason for blocked mail.
  • Check Your Score: A low score while using a strong policy means you are likely losing real emails.
  • Verify Rules: Make sure your security policy is actually active in your DNS.
  • Use the Fix Plan: Follow the steps to give your email vendors the right instructions.

Production Usage: Fixing Mail

How a support team uses the API to fix a customer's blocked emails.

  1. A customer says their emails aren't reaching people.
  2. The support agent runs a Veldica Pro audit on the customer's domain.
  3. The agent finds that a new email tool is not signing or sending with an aligned domain.
  4. The agent gets a fix-plan and tells the customer exactly what to update in their DNS.
  5. The customer makes the change, and the agent checks again to make sure it's fixed.
Integration Example (Node.js)
const audit = await veldica.proAudit('veldica.com');

const alignmentIssue = audit.findings.find(f => f.id === 'dmarc.alignment.failed');
if (alignmentIssue && audit.risk.enforcement_status === 'fully_enforced') {
  console.log('ALERT: Your mail is being blocked because of a setup error.');
}

Tool Comparison: Finding Errors

Why Veldica is faster than checking old reports.

Report Tools

Good for long-term trends, but too slow to fix a problem happening currently.

Manual Checks

Hard to do correctly and requires a lot of technical expert knowledge.

Veldica API

Provides an instant, expert check of your current settings and errors.

Keep Exploring

Use the Workflow Library to browse more guides, comparisons, and integration examples to continue your evaluation.

Fix your email delivery

Don't let strong security block your real emails. Use the Veldica API to find and fix errors before they hurt your business.