Integrations

API Keys

Generate and manage API keys

Overview

API keys provide programmatic access to the v1 API endpoints. Use them to send emails, manage contacts, and integrate the platform into your own applications. Keys are hashed before storage and are only shown once at creation time — make sure to copy and save your key immediately.

List Keys

Retrieve all API keys associated with your account. For security, only the key prefix and metadata are returned — the full key is never shown again after creation.

GET/api/keys

List all API keys for the current account.

Response

json

{
  "keys": [
    {
      "id": 1,
      "name": "Production App",
      "prefix": "em_prod_a3f8",
      "created_at": "2026-01-15T10:30:00Z",
      "last_used": "2026-03-02T14:22:00Z"
    },
    {
      "id": 2,
      "name": "Staging",
      "prefix": "em_stg_b7c2",
      "created_at": "2026-02-20T08:00:00Z",
      "last_used": null
    }
  ]
}

Create Key

Generate a new API key. The full key is returned only in this response — it cannot be retrieved again. Store it securely in your application's environment variables.

POST/api/keys

Create a new API key. The key is only shown once in the response.

Parameters

Name	Type	Description
`name`*	string	A descriptive name for the key (e.g. 'Production App')

Request

json

{
  "name": "Production App"
}

Response

json

{
  "key": "em_prod_a3f8x9k2m4n7p1q5r8s0t3v6w9y2z4",
  "prefix": "em_prod_a3f8"
}

Using API Keys

Include your API key in the Authorization header as a Bearer token. All v1 API requests must include this header or they will receive a 401 Unauthorized response.

cURL Example

curl -X POST https://yourapp.com/api/v1/send \
  -H "Authorization: Bearer em_prod_a3f8x9k2m4n7p1q5r8s0t3v6w9y2z4" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "jane@example.com",
    "subject": "Hello from the API",
    "html": "<p>Sent via the v1 API.</p>"
  }'

V1 Endpoints

The external v1 API exposes a streamlined set of endpoints for programmatic use. All v1 endpoints require a valid API key in the Authorization header.

POST /api/v1/send — Send an email programmatically with recipient, subject, and HTML body.
GET /api/v1/contacts — Retrieve your contact list with pagination support.

These endpoints are designed for server-to-server integration. For full documentation of request and response schemas, see the API Reference section.

AI Features Webhooks