Grosend|Docs
Getting Started
  • Introduction
  • Quick Start
Sending
  • SMTP Relay
  • Authentication
Automation
  • Overview
API Reference
  • Overview
  • Send Email
  • Domains
  • Templates
  • API Keys
  • Webhooks
Analytics
  • Tracking
Docs
Getting Started
  • Introduction
  • Quick Start
Sending
  • SMTP Relay
  • Authentication
Automation
  • Overview
API Reference
  • Overview
  • Send Email
  • Domains
  • Templates
  • API Keys
  • Webhooks
Analytics
  • Tracking

Domains

Verify sending domains and manage DNS records for DKIM, SPF, and DMARC.

Create a domain

Terminal
curl -X POST https://api.grosend.com/api/v1/domains \
  -H "Authorization: Bearer sv_live_..." \
  -H "Content-Type: application/json" \
  -d '{"domain": "yourdomain.com"}'

Response

201 Created
{
  "id": "domain-uuid",
  "domain": "yourdomain.com",
  "status": "unverified",
  "verifiedAt": null,
  "createdAt": "2025-01-15T10:30:00Z"
}

Verify a domain

After adding the DNS records, call verify to check propagation. SPF and MX records are required for verification.

Terminal
curl -X POST https://api.grosend.com/api/v1/domains/{domain-id}/verify \
  -H "Authorization: Bearer sv_live_..."

Response

200 OK
{
  "status": "verified",
  "domain": "yourdomain.com",
  "dns": {
    "spf": true,
    "dkim": true,
    "dmarc": false,
    "mx": true
  }
}
Domain verification requires SPF and MX to pass. DKIM and DMARC are checked but not required for verification.

List domains

Terminal
curl https://api.grosend.com/api/v1/domains \
  -H "Authorization: Bearer sv_live_..."

Delete a domain

Terminal
curl -X DELETE https://api.grosend.com/api/v1/domains/{domain-id} \
  -H "Authorization: Bearer sv_live_..."