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 Keys

Manage API keys for authenticating with the Grosend API.

List API keys

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

Create an API key

Terminal
curl -X POST https://api.grosend.com/api/v1/api-keys \
  -H "Authorization: Bearer sv_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production API Key",
    "scopes": ["send:email"]
  }'

Response

201 Created
{
  "id": "key-uuid",
  "name": "Production API Key",
  "key": "sv_live_...",
  "isActive": true,
  "scopes": ["send:email"],
  "createdAt": "2025-01-15T10:30:00Z"
}
The API key is only shown once at creation time. Store it securely — you cannot retrieve it later.

Revoke an API key

Terminal
curl -X DELETE "https://api.grosend.com/api/v1/api-keys?id={key-id}" \
  -H "Authorization: Bearer sv_live_..."
The delete endpoint uses a query parameter: ?id=

Using API keys

Pass the API key in the Authorization header as a Bearer token:

Header
Authorization: Bearer sv_live_your_key_here