Grosend|Docs
Getting Started
  • Introduction
  • Quick Start
Sending
  • SMTP Relay
  • Authentication
API Reference
  • Overview
  • Send Email
  • Domains
  • Templates
  • API Keys
  • Webhooks
Analytics
  • Tracking
Docs
Getting Started
  • Introduction
  • Quick Start
Sending
  • SMTP Relay
  • Authentication
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://send.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": "pending",
  "dnsRecords": [
    {"type": "TXT", "name": "sendv._domainkey", "value": "v=DKIM1; k=ed25519; ..."},
    {"type": "TXT", "name": "@", "value": "v=spf1 include:_spf.sendvanta.test ~all"},
    {"type": "TXT", "name": "_dmarc", "value": "v=DMARC1; p=none;"}
  ]
}

Verify a domain

After adding the DNS records, call verify to check propagation:

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

Response

200 OK
{
  "id": "domain-uuid",
  "domain": "yourdomain.com",
  "status": "verified",
  "verifiedAt": "2025-01-15T11:00:00Z"
}
Domain verification may take a few minutes to propagate. If verification fails, double-check your DNS records.

List domains

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

Delete a domain

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