Quickstart

Prerequisites

For the BYOC path you need:

• →An AWS account. If its SES account is still in the sandbox, SendFleet requests production access for you from the dashboard
• →A domain you control, so you can add DNS records
• →Permission to create IAM roles in that AWS account

How to send your first transactional email with SendFleet

1. 1

   Create a SendFleet account

   Register at sendfleet.net/register. Email verification is required before you can send. The Free BYOC plan costs nothing and includes 3,000 emails per month, no card needed.
2. 2

   Create an IAM role in AWS

   Open Dashboard → AWS and press Create the role in AWS. AWS CloudFormation opens a ready-made stack that creates the role SendFleet-BYOC-Role with your unique ExternalId already filled in. Tick the IAM acknowledgement and press Create stack. Full walkthrough in BYOC Setup.
3. 3

   Connect your IAM role

   Copy RoleArn from the stack's Outputs tab, paste it into Dashboard → AWS and press Connect. We confirm that the role can be used, find the region where your SES account has production access, and set up delivery tracking in your account.

   Example Role ARN

   arn:aws:iam::123456789012:role/SendFleet-BYOC-Role

4. 4

   Add and verify a sending domain

   Go to Dashboard → Domains → Add BYOC domain and enter your root domain, for example acme.com. We register the identity in your SES account and show you the DNS records to add. Once both ownership TXT records have propagated, choose Verify ownership, then Verify DKIM. A domain is send-ready only once both checks pass.
5. 5

   Generate an API key

   Go to Dashboard → API Keys → New key and give it a name such as "Production". You land on the send page with the full key in a copy box at the top and the example requests below already using it. It is displayed exactly once, so copy it into your environment variables or secrets manager. Only a SHA-512 hash is stored, so a lost key cannot be recovered.
   
   Optionally restrict the key to specific sending domains under Domain scope. A scoped key can only send from the domains you pick; leave it empty and the key can send from all of them.
6. 6

   Send your first email

   Replace YOUR_API_KEY and hello@acme.com with your own key and verified domain.

   cURLPythonNode.jsPHP

   cURLcopy

   curl -X POST https://api.sendfleet.net/v1/send \
     -H "X-API-Key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "to": "user@example.com",
       "from_email": "hello@acme.com",
       "from_name": "Acme",
       "subject": "Welcome aboard",
       "message": "Thanks for signing up!"
     }'

Successful response

A 200 OK means your email was accepted and queued. Delivery happens asynchronously, so this is an acceptance receipt rather than proof of delivery.

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

Next steps