Docs/Quick Start

Quick Start

Get up and running with FWD in under 5 minutes. This guide walks you through creating an account, generating an API key, and sending your first email.

1. Create an Account

Sign up for a free account at fwd.email/auth/signup. No credit card required — the free plan includes 100 emails per month.

2. Generate an API Key

Navigate to the API Keys section in your dashboard and create a new key. Give it a descriptive name like “Production” or “Development”.

Save your API key

Your full API key is only shown once at creation time. Copy and store it securely — you won't be able to see it again.

3. Send Your First Email

Use the x-api-key header to authenticate, and send a POST request to /api/send:

cURL
curl -X POST https://fwd.sarthak.online/api/send \
  -H "x-api-key: fwd_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example.com",
    "subject": "Hello from FWD!",
    "html": "<h1>Welcome!</h1><p>Your first email via FWD.</p>"
  }'
Node.js
const response = await fetch("https://fwd.sarthak.online/api/send", {
  method: "POST",
  headers: {
    "x-api-key": "fwd_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    to: "user@example.com",
    subject: "Hello from FWD!",
    html: "<h1>Welcome!</h1><p>Your first email via FWD.</p>",
  }),
});

const data = await response.json();
console.log(data);
Python
import requests

response = requests.post(
    "https://fwd.sarthak.online/api/send",
    headers={
        "x-api-key": "fwd_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "to": "user@example.com",
        "subject": "Hello from FWD!",
        "html": "<h1>Welcome!</h1><p>Your first email via FWD.</p>",
    },
)
print(response.json())

Successful Response

Response (200 OK)
{
  "success": true,
  "emailId": "abc123-def456",
  "messageId": "msg_789",
  "status": "queued",
  "rateLimit": {
    "limit": 100,
    "remaining": 99
  }
}

Next Steps