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

API Reference

All endpoints return JSON. Authenticate with a Bearer token in the Authorization header.

Base URL: https://api.grosend.com
Auth: Authorization: Bearer sv_live_...

Emails

POST/api/v1/emailsSend an email
POST/api/v1/emails/batchSend batch emails (up to 100)
GET/api/v1/emailsList sent emails
GET/api/v1/emails/:idGet email details
GET/api/v1/emails/scheduledList scheduled emails
DELETE/api/v1/emails/:idCancel scheduled email

Domains

POST/api/v1/domainsCreate a domain
GET/api/v1/domainsList domains
GET/api/v1/domains/:idGet domain details
POST/api/v1/domains/:id/verifyVerify domain DNS
DELETE/api/v1/domains/:idDelete a domain

Templates

POST/api/v1/templatesCreate template
GET/api/v1/templatesList templates
GET/api/v1/templates/:idGet template details
PUT/api/v1/templates/:idUpdate template
DELETE/api/v1/templates/:idDelete template

Webhooks

POST/api/v1/webhooksCreate webhook
GET/api/v1/webhooksList webhooks
GET/api/v1/webhooks/:idGet webhook details
PUT/api/v1/webhooks/:idUpdate webhook
DELETE/api/v1/webhooks/:idDelete webhook
GET/api/v1/webhooks/:id/deliveriesGet delivery logs

API Keys

POST/api/v1/api-keysCreate API key
GET/api/v1/api-keysList API keys
DELETE/api/v1/api-keys?id=Revoke API key

Account & Analytics

GET/api/v1/accountGet account info
PUT/api/v1/accountUpdate account
POST/api/v1/account/passwordChange password
GET/api/v1/account/creditsGet credit balance
GET/api/v1/account/credits/transactionsCredit transaction history
GET/api/v1/smtpGet SMTP config
GET/api/v1/analytics/overviewAnalytics overview
GET/api/v1/analytics/timeseriesAnalytics time series
GET/api/v1/analytics/top-linksTop clicked links

Response format

Send email returns a minimal response. Use GET /api/v1/emails/:id for full details.

JSON Response
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "queued"
}

Error handling

Error Response
{
  "error": "Domain not verified"
}

Errors return HTTP status codes: 400 validation, 401 auth, 403 forbidden, 404 not found, 429 rate limit, 500 server error.