saasmail: Skill for Claude Code

Using the saasmail HTTP API

saasmail is a self-hosted email server on Cloudflare Workers. Once a user has a deployed instance, they interact with it from their own apps over HTTP. This skill covers the three things callers do most:

1. Send a one-off email (with or without attachments).
2. Send an email rendered from a saved template.
3. Enroll a person in a sequence (a multi-step drip campaign), and manage that enrollment.

If the user hasn't deployed saasmail yet, point them at /saasmail-onboarding first — without a running instance there's no API to call.

Two pieces of info you always need

Before writing any request, get these from the user (or confirm them):

• Base URL — the host their instance is deployed at, e.g. https://mail.example.com. There is no shared SaaS endpoint; every instance is the user's own Worker.
• API key — a string like sk_abc123.... Generated in the saasmail UI under Settings → API Keys (or POST /api/api-keys). It's shown once at creation. Send it as Authorization: Bearer sk_... on every request.

If the user hasn't created a key yet, tell them where to do it rather than guessing. Keys are gated behind a passkey in non-dev environments, so they may need to register a passkey first.

The other parameter that comes up in nearly every request is fromAddress. It must be one of the sender identities configured in that instance (the addresses the user verified during onboarding, like [email protected]). Sending from an unverified address returns a permission error — don't invent one.

1. Send a one-off email

POST /api/send — content type multipart/form-data (not JSON). The body has:

• A payload field whose value is a JSON-encoded string of the email body.
• Zero or more files fields, each an attachment.

This shape is unusual but deliberate: it lets the same endpoint handle plain sends and sends with attached files without a separate route.

Minimum payload

{
  "to": "[email protected]",
  "fromAddress": "[email protected]",
  "subject": "Welcome",
  "bodyHtml": "<p>Hello!</p>"
}