Documentation

SendFleet API

One REST endpoint. Two infrastructure modes. Send transactional email through your own AWS SES account (BYOC) or our managed shared infrastructure - same API key, same JSON payload, same response shape.

Quickstart

From zero to first send in under 5 minutes.

Authentication

API keys, security model, and hashing.

Send Email

Full reference for POST /api/send/.

BYOC Setup

Connect your own AWS SES account.

Webhooks

Real-time delivery event callbacks.

Error Codes

HTTP status codes and error_code reference.

How it works

SendFleet sits between your application and AWS SES. You make a single HTTP request. We route it through the appropriate infrastructure based on your domain's sending_mode.

Your App

POST /api/send/

SendFleet

Route & queue

BYOC → Your SES

Shared → Managed SES

The routing decision is made automatically based on the sending mode set on the domain you use in from_email. The mode is fixed at domain creation time and cannot be changed. BYOC domains are registered in your AWS SES account; Shared domains are registered in SendFleet's SES.

Base URL

https://sendfleet.net/api/send/

Request format

All API requests must include Content-Type: application/json and your API key in the X-API-Key header. Request bodies are JSON. Responses are always JSON.

Choosing a mode

Requirement	BYOC	Shared SES
Email content stored on our servers	Never	Yes (90 days)
AWS account required	Yes (yours)	No
Sender reputation	Your SES account	Shared pool
Email logs in dashboard	Not stored	Yes
Webhooks	Not available	Yes
Manual account approval	Not required	Required

Successful response

A 200 OK means your email has been accepted and queued. Delivery happens asynchronously.

200 OK

{
  "success":    true,
  "message":    "Email queued for delivery via your SES account.",
  "message_id": "1a2b3c4d-5e6f-7890-abcd-ef1234567890",
  "mode":       "byoc"
}

Next steps

Topic	Description
Send Email reference	All request parameters, HTML support, reply-to.
DNS records	Add SPF, DKIM, MAIL FROM, DMARC for maximum deliverability.
Error codes	Understand and handle every possible error response.
Plans & limits	Rate limits, monthly quotas, and upgrade paths.

Next Quickstart