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

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://send.grosend.com/api/v1/domains \
  -H "Authorization: Bearer sv_live_..." \
  -H "Content-Type: application/json" \
  -d '{"domain": "yourdomain.com"}'

The response includes the DNS records you need to add. Once verified, you can start sending.

3. Send an email

Terminal
curl -X POST https://send.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>"
  }'
Check the response for the id field. Use it to track delivery status via the logs endpoint.

4. Check delivery

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