Manage sending domains, DMARC/SPF/DKIM records, inbound email, and dedicated IP pools.

Domains & IPs

Sending domains

List domains

GET /v1/dmarc/domains

Add domain

POST /v1/dmarc/domains

{
  "domain": "yourdomain.com"
}

Response includes DNS records to add (SPF, DKIM, DMARC).

Verify domain

POST /v1/dmarc/domains/:id/verify

MisarMail performs a live DNS lookup. Returns:

{
  "success": true,
  "verified": true,
  "checks": {
    "spf": { "status": "pass", "record": "v=spf1 include:spf.misar.io ~all" },
    "dkim": { "status": "pass" },
    "dmarc": { "status": "pass", "policy": "quarantine" }
  }
}

Remove domain

DELETE /v1/dmarc/domains/:id

Get DKIM record

GET /v1/dmarc/domains/:id/dkim

Returns the DKIM TXT record selector and value to publish in DNS.

Mailboxes

Manage IMAP/SMTP mailboxes on a domain (for the unified inbox):

GET    /v1/dmarc/domains/:id/mailboxes
POST   /v1/dmarc/domains/:id/mailboxes
DELETE /v1/dmarc/domains/:id/mailboxes/:mailboxId

Inbound email

Configure an inbound domain to receive emails via webhook:

List inbound domains

GET /v1/inbound

Add inbound domain

POST /v1/inbound

{
  "domain": "inbound.yourdomain.com",
  "webhookUrl": "https://yourapp.com/hooks/email"
}

MisarMail will POST parsed email objects to webhookUrl for each received message:

{
  "from": "[email protected]",
  "to": "[email protected]",
  "subject": "Help request",
  "html": "...",
  "text": "...",
  "attachments": [],
  "headers": {},
  "receivedAt": "2025-06-15T10:00:00Z"
}

Remove inbound domain

DELETE /v1/inbound/:id

Dedicated IPs

Dedicated IPs are available on Business and Enterprise plans.

List dedicated IPs

GET /v1/dedicated-ips

Assign to pool

POST /v1/dedicated-ips

{
  "ip": "198.51.100.42",
  "poolId": "pool_01ABCDEF"
}

Update IP settings

PATCH /v1/dedicated-ips/:id

Remove IP

DELETE /v1/dedicated-ips/:id

IP Warmup

New dedicated IPs must be warmed up gradually to build sender reputation. Check warmup status:

GET /v1/warmup

{
  "ip": "198.51.100.42",
  "status": "warming",
  "dayOfWarmup": 7,
  "dailyLimit": 2000,
  "recommendation": "Maintain consistent volume. Avoid spikes."
}

Start or update a warmup schedule:

POST /v1/warmup
PUT  /v1/warmup/:id

Deliverability audit

POST /v1/deliverability/audit

Runs a full check of your sending infrastructure and returns a score (0–100) plus actionable recommendations.

{
  "score": 87,
  "grade": "B+",
  "issues": [
    {
      "severity": "warning",
      "category": "dmarc",
      "message": "DMARC policy is 'none'. Upgrade to 'quarantine' for better protection."
    }
  ],
  "recommendations": ["Set DMARC to p=quarantine", "Enable BIMI"]
}