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

Quick Start

Get your first email sent in under 2 minutes.

1. Get your API key

  1. Log in at send.grosend.com
  2. Go to Settings → SMTP & API
  3. Click Create API Key
  4. Copy the key — it starts with sv_live_

2. Verify your domain

Before sending, you need to verify your domain and configure DNS records (DKIM, SPF, DMARC).

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

The response includes the domain ID. Add the required DNS records, then verify.

3. Send an email

Terminal
curl -X POST https://api.grosend.com/api/v1/emails \
  -H "Authorization: Bearer sv_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hello@yourdomain.com",
    "to": ["recipient@example.com"],
    "subject": "Welcome to Grosend",
    "html": "<h1>Hello!</h1><p>Your email platform is ready.</p>"
  }'

4. Check delivery

Terminal
curl https://api.grosend.com/api/v1/emails/{email-id} \
  -H "Authorization: Bearer sv_live_..."
Status lifecycle
queued → sent → delivered or bounced / failed
Scheduled emails: scheduled → queued → ...