SendFleet API reference

Reference

• QuickstartFrom zero to first send in under 5 minutes.
• AuthenticationAPI keys, domain scoping, and the security model.
• Send EmailFull reference for POST /v1/send.
• Current AccountIdentity, verification status, and current-month usage.
• BYOC SetupConnect your own AWS SES account.
• WebhooksSigned, real-time delivery event callbacks.
• Error CodesEvery HTTP status and error code explained.
• WordPress PluginSend every wp_mail() email through SendFleet.

How it works

SendFleet sits between your application and AWS SES. You make a single HTTP request; we accept it, queue it, and deliver it asynchronously. Which SES account delivers the mail depends on the sending mode of the domain in your from_email.

Base URL

https://api.sendfleet.net/v1

Use this base URL for authenticated API requests. The supported endpoints are listed below; their links describe the request and response contracts.

Request format

Authenticate both endpoints with the X-API-Key header. For sending, use Content-Type: application/json and a JSON request body. GET /v1/me does not require a request body. API responses are JSON.

Choosing a mode

Not sure? BYOC gives you an isolated sender reputation, and SendFleet never stores BYOC message bodies in its database; recipients and subjects only while email logs are on. Shared SES needs no AWS account at all and includes dashboard logs, webhooks, and managed bounce handling on every Managed plan. See BYOC Setup or Shared SES.

Successful response

A 200 OK means the email was accepted and queued. Delivery happens asynchronously, so this is not yet a delivery confirmation.

{
  "success":         true,
  "message":         "Email queued for delivery.",
  "message_id":      "1a2b3c4d-5e6f-7890-abcd-ef1234567890",
  "idempotency_key": "8f14e45fceea167a5a36dedd4bea2543",
  "mode":            "shared"
}

idempotency_key is the value to store: it appears on every webhook fired for this send, so it is how you tie a response to its delivery events. It is returned on Shared SES, and on BYOC while delivery tracking is on. Full field reference on the Send Email page.

Next steps