Documentation

Quick Start.

Send your first email with SMTPfast in under two minutes.

Overview

SMTPfast is a developer-first email API built for speed and simplicity. Send transactional emails, manage sending domains, and track delivery events through a clean REST API.

The API is compatible with Resend, so you can switch with minimal code changes.

Base URL

text
https://smtpfa.st/api/v1

All endpoints described in these docs are relative to this base URL.

Authentication

Every request requires a Bearer token in the Authorization header. Create an API key from your dashboard or via the API.

Header
Authorization: Bearer sf_live_your_api_key

Send Your First Email

Make a POST request to /v1/emails with the recipient, subject, and body.

Verify your sending domain first. A send from a domain you have not verified is refused with 403 and the message Domain is not verified. Add it on the Domains page, publish the DNS records, and then come back here. The example below uses yourapp.com; replace it with a domain you own.
curl -X POST https://smtpfa.st/api/v1/emails \
  -H "Authorization: Bearer sf_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "[email protected]",
    "to": ["[email protected]"],
    "subject": "Welcome!",
    "html": "<h1>Hello from SMTPfast!</h1>"
  }'

Response Format

Responses are JSON, apart from exports such as /v1/contacts/export which returns CSV. A successful request returns 200, or 201 when it created something. An error carries an error field with a message that describes the issue; the HTTP status code says what kind of error it is.

Success

json
{
  "id": "email_abc123"
}

Error

json
{
  "error": "Invalid API key"
}

Next Steps