Wayletter

Getting Started

1. What this is: a Wayletter sending service, not a Gmail inbox. The default transport is sink — messages are stored here, not delivered to the public internet until relay (WAYLETTER_RELAY_*) is configured.
2. API key: Create one on the Keys tab (or paste in the header). The plaintext secret is shown once.
3. First send: replace YOUR_API_KEY and run this in a terminal. Customers should not rely on our Activity tab for stats — consume the event stream (GET /wayletter/v1/events/stream or wayletter.Client.StreamEvents). Example clients: Go, Node, curl, PowerShell, MCP JSON in apps/wayletter/examples/. Activity is only a local operator peek. Send to http://127.0.0.1:8080/v1/send (not /wayletter/v1/send).

   curl -sS -X POST http://127.0.0.1:8080/v1/send \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"from":{"email":"from@example.test","name":"Sender"},"personalizations":[{"to":[{"email":"to@example.test"}]}],"subject":"Hello from wayletter","content":[{"type":"text/plain","value":"Hello"},{"type":"text/html","value":"<p>Hello</p>"}]}'

4. Optional — send from a mail app (SMTP): skip unless you want Thunderbird, nodemailer, etc. to talk to this server. Fill the app’s outgoing server like this:

   Field	What to type
   Server / host	127.0.0.1
   Port	2525
   Username	the word apikey (not your email)
   Password	paste the same API key from step 2

   If the app asks for a login method, pick PLAIN or LOGIN. Encryption can stay off for this local port.
5. Skip these for a first send:
   • Templates tab — reusable emails. Put {{name}} in the subject or body; those words get filled in when you send.
   • Domain DNS tab — copy SPF / DKIM / DMARC records when you later send as a real domain (still needs relay; sink does not publish mail).
   • Webhooks tab — if you want this server to POST delivery events to a URL you control.
6. Let someone else send through this server: on Keys, create a key for them (do not give them yours). Then send:
   • The site address: http://127.0.0.1:8080 (or your machine’s host if they are not on this PC)
   • Tell them to POST /v1/send with Authorization: Bearer their key
   • Or SMTP: host 127.0.0.1, port 2525, username apikey, password = their key
7. To sell this: set WAYLETTER_STRIPE_*, open Plans, Buy. Checkout collects tax where you have a Stripe Tax registration (test vs live are separate).