DNSPulse Documentation

Quick Navigation

Getting Started

1. Create Your Account

Sign up for a free account to start monitoring your email infrastructure. No credit card required for the free tier.

2. Add Your Domain

Navigate to your dashboard and click "Add Domain". Enter your sending domain (e.g., mail.yourdomain.com) and optionally add your sending IP address for comprehensive analysis.

Example: mail.example.com or 192.168.1.100

3. Run Your First Check

Click "Run Check" to trigger a comprehensive analysis of your domain's email infrastructure. This includes:

  • DNS authentication records (SPF, DKIM, DMARC)
  • Sender reputation across multiple reputation and abuse signal systems
  • Network intelligence and shared IP analysis
  • Warm Index score calculation (0-100)

4. Review Your Report

Your comprehensive report will show your Warm Index score, detailed DNS configuration status, reputation insights, and actionable recommendations to improve deliverability.

Why Choose DNSPulse?

DNSPulse is the most comprehensive email deliverability monitoring platform designed for email marketers, developers, and businesses who depend on email for critical communications.

Real-Time Monitoring

Get instant feedback on your email infrastructure health. Our platform runs checks in seconds, not hours, so you can identify and fix issues before they impact your campaigns.

Actionable Insights

Don't just get data—get recommendations. Every issue flagged includes specific steps to resolve it, with links to documentation and reputation signal remediation forms.

Comprehensive Coverage

Monitor DNS authentication (SPF, DKIM, DMARC), evaluate infrastructure against multiple reputation and abuse signal systems, analyze network intelligence, and track sender reputation—all in one unified platform.

Save Time & Money

Prevent deliverability issues before they cost you revenue. Automated monitoring means you spend less time troubleshooting and more time on what matters—your business.

Historical Tracking

Track your Warm Index score over time. Visualize improvements, identify trends, and demonstrate ROI from your deliverability optimization efforts.

Easy to Use

No complex setup or technical expertise required. Add your domain, run a check, and get a clear readiness score with visual breakdowns anyone can understand.

Who Benefits from DNSPulse?

📧 Email Marketers

Ensure campaigns reach the inbox, not spam. Monitor deliverability before sending to protect your sender reputation.

👨‍💻 Developers

Validate DNS configurations, debug email delivery issues, and integrate deliverability checks via API into your applications.

🏢 Businesses

Protect revenue from lost emails. Monitor transactional email infrastructure to ensure critical communications are delivered.

Understanding Your Metrics

Warm Index Score (0-100)

Your overall email deliverability readiness score. This composite metric combines DNS authentication, reputation, and network intelligence.

85-100
Excellent

Ready to send. High inbox placement expected.

70-84
Good

Minor issues. Address recommendations.

50-69
Fair

Significant issues. Fix before sending.

0-49
Poor

Critical issues. Do not send yet.

How is the score calculated?

  • DNS Authentication (40%): SPF, DKIM, DMARC configuration
  • Reputation (35%): Multiple reputation and abuse signal systems
  • Network Intelligence (25%): Shared IP risks, recent activity

DNS Authentication Status

SPF (Sender Policy Framework)

Authorizes which mail servers can send email on behalf of your domain. Status shows PASS, FAIL, or NOT_FOUND.

DKIM (DomainKeys Identified Mail)

Cryptographic signature that proves email authenticity. Shows record detection and selector validity.

DMARC (Domain-based Message Authentication)

Instructs receivers what to do with emails that fail SPF/DKIM. Shows policy (none/quarantine/reject) and reporting setup.

Reputation Metrics

Reputation Status

Your domain and IP are evaluated against multiple reputation systems and abuse signal sources. Any risk indicators are flagged for review.

Domain Reputation

Historical performance indicators for your domain. Factors include observed abuse signals and infrastructure health metrics.

IP Reputation

Quality score based on derived infrastructure diagnostics. Evaluates infrastructure-level risk signals and association with historical abuse indicators.

DNS Records Configuration Guide

Important

Always test your DNS changes in a staging environment first. Incorrect records can prevent email delivery entirely.

Setting up SPF

Add a TXT record to your domain's DNS with your authorized sending servers:

v=spf1 include:_spf.google.com include:sendgrid.net ~all

Replace the includes with your actual mail providers. Use ~all for soft fail or -all for hard fail.

Setting up DKIM

Your email service provider will generate a DKIM key pair. Add the public key as a TXT record:

selector._domainkey.yourdomain.com
v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA...

The selector name (e.g., "default", "s1", "google") is provided by your email service.

Setting up DMARC

Start with a monitoring policy and gradually move to enforcement:

_dmarc.yourdomain.com
v=DMARC1; p=none; rua=mailto:dmarc@yourdomain.com; pct=100
  • p=none: Monitor only (recommended to start)
  • p=quarantine: Send failed emails to spam
  • p=reject: Block failed emails completely
  • rua: Email address for aggregate reports

Understanding Network Intelligence

Network Intelligence analyzes your sending IP infrastructure to identify potential deliverability risks from shared hosting environments.

Shared IP Pool Detection

When your IP is part of a shared pool (multiple senders using the same IPs), your deliverability is affected by all senders on that infrastructure.

⚠️ High Risk Indicator

If we detect malicious content or policy violations from your shared IP pool, your Warm Index score will be significantly reduced. Mailbox providers treat the entire IP as high-risk.

Recent Activity Analysis

We track the last 30 days of email activity from your IP addresses to identify:

  • Volume patterns and sending spikes
  • Spam trap hits and malicious triggers
  • Malicious content or threat detection
  • Shared infrastructure with known bad actors

What You Can Do

  • Dedicated IPs: Request a dedicated sending IP from your ESP to avoid shared pool risks
  • ESP Review: Choose email service providers with strict abuse policies and good reputation management
  • Monitor Regularly: Check your Warm Index weekly to catch reputation issues early

Technology Stack

DNSPulse is built with modern, enterprise-grade technologies to ensure reliability, performance, and security.

Frontend

Next.js 15

React framework with App Router for server-side rendering and optimal performance

TypeScript

Type-safe development for fewer bugs and better developer experience

Tailwind CSS v4

Utility-first CSS framework for rapid, responsive UI development

Shadcn/UI

Beautifully designed, accessible component library

Recharts

Interactive data visualization for Warm Index trends

Backend

Next.js API Routes

Serverless functions for scalable, edge-optimized APIs

Drizzle ORM

Type-safe database queries with excellent TypeScript support

Turso (LibSQL)

Edge-native SQLite database for low-latency global access

Better-Auth

Modern authentication framework with session management

External Services

DNS Lookup APIs

Real-time SPF, DKIM, DMARC record validation

Reputation Services

Multiple reputation systems and abuse signal sources

SpamTrapSources

Spam trap and malicious sender detection network

IP Intelligence APIs

Network activity monitoring and shared pool detection

Infrastructure

Vercel Deployment

Global edge network for instant page loads worldwide

Edge Computing

Run checks closer to users for minimal latency

CDN Caching

Intelligent caching for frequently accessed reports

Automatic Scaling

Serverless architecture scales instantly with demand

Security & Compliance

🔒 End-to-End Encryption

All data in transit is encrypted with TLS 1.3. Database records are encrypted at rest.

🛡️ GDPR Compliant

30-day automatic data retention. Full data export and deletion on request.

🔐 Secure Authentication

Bcrypt password hashing, session-based auth, and optional 2FA support.

📊 Privacy First

Your domain data is never shared. No third-party analytics or tracking.

<2s
Average Check Time
99.9%
Platform Uptime
Multiple
Reputation Systems Monitored
100ms
Global Edge Latency

API Reference

Professional Plan

The DNSPulse API allows you to programmatically check domain health, retrieve reports, and integrate deliverability monitoring into your applications.

Credit Validation Required

All API requests validate your credit balance before execution. Each domain check consumes 1 credit. Ensure you have sufficient credits before making requests.

Authentication

All API requests require a bearer token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

Quick Start: One-Click Domain Check

Run a complete domain analysis with a single command. This creates a domain, runs all checks, and returns the report URL.

One-LinerCopy and paste directly
DOMAIN_ID=$(curl -s -X POST https://dnspulse.hamcut.in/api/external/domains -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"domainName":"quicktest.com","ipAddress":"8.8.8.8"}' | jq -r '.domain.id') && curl -s -X POST https://dnspulse.hamcut.in/api/external/domains/$DOMAIN_ID/run -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" && echo -e "\n✅ Report URL: https://dnspulse.hamcut.in/api/external/domains/$DOMAIN_ID/report"

💡 Requires jq for JSON parsing. Install: brew install jq (Mac) or sudo apt-get install jq (Linux)

Multi-LineMore readable format
# Step 1: Create domain and capture ID DOMAIN_ID=$(curl -s -X POST https://dnspulse.hamcut.in/api/external/domains \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"domainName":"quicktest.com","ipAddress":"8.8.8.8"}' \ | jq -r '.domain.id') # Step 2: Run DNS checks (consumes 1 credit) curl -s -X POST https://dnspulse.hamcut.in/api/external/domains/$DOMAIN_ID/run \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" # Step 3: Display report URL echo -e "\n✅ Report URL: https://dnspulse.hamcut.in/api/external/domains/$DOMAIN_ID/report"

Customize Your Request

API Key:
YOUR_API_KEY

Get from Dashboard → Settings

Domain Name:
quicktest.com

Your sending domain

IP Address:
8.8.8.8

Your sending IP (optional)

Cost:
1 credit per check

Validated before execution

Example Response

{ "success": true, "message": "All checks completed", "result": { "nars": 42, "confidence": 15, "tier": "RISKY", "reasons": [ "SPF present", "Missing DKIM record", "Missing DMARC policy", "No reputation issues detected" ], "dns": { "spfOk": true, "dkimOk": false, "dmarcPolicy": null } } } ✅ Report URL: https://dnspulse.hamcut.in/api/external/domains/26/report

🚀 What This Command Does

  1. 1.Creates domain: Adds your domain to the monitoring system and returns a unique domain ID
  2. 2.Validates credits: Checks if you have sufficient credits (1 required) before running checks
  3. 3.Runs all checks: DNS authentication, reputation signals, intelligence, network intelligence (takes ~2-5 seconds)
  4. 4.Returns report URL: Open the URL in your browser to see the full HTML report with visualizations

Individual Endpoints

GET/api/domains

List all monitored domains

POST/api/domains

Add a new domain to monitor

{ "domain": "mail.example.com", "ip": "192.168.1.1" }
GET/api/domains/:id/report

Get comprehensive deliverability report for a domain

POST/api/checks/trigger

Trigger a new check for a domain

{ "domainId": "123" }

Need API Access?

API access is included with Professional plans ($40/month). Upgrade to start integrating DNSPulse into your workflow.

Frequently Asked Questions

How often should I run checks?

We recommend running checks weekly for ongoing monitoring, and immediately after making any DNS changes or switching email service providers.

What if my Warm Index score is low?

Review the detailed breakdown in your report. Fix DNS authentication issues first (highest impact), then address reputation problems, and consider dedicated IP infrastructure if on shared pools.

Can I monitor multiple domains?

Yes! Add as many domains as you need. Each check consumes one credit from your plan allowance.

Do unused reports roll over?

Yes, on Starter and Professional subscription plans. Unused monthly reports roll over to the next month (up to 2x your plan limit).

How do I resolve reputation issues?

Each reputation system has its own remediation process. Your report includes direct links to remediation request forms for any signals where you're identified.

Still Have Questions?

Our support team is here to help you optimize your email deliverability