Mailer

Send transactional emails programmatically using the Stormkit Mailer API

The Mailer API allows you to send transactional emails from your Stormkit environments.

Prerequisites

Before using the Mailer API:

1. Configure the mailer settings for your environment (see Mailer documentation)
2. Generate an Environment-level API Key

Send Email

POST /v1/mailer · endpoint

Send a transactional email.

Request Body

to · string · required

Recipient email address. For multiple recipients, separate with semicolons (;)

from · string · required

Sender email address (can include name: “Jane Doe <[e-mail]>”)

subject · string · required

Email subject line

body · string · required

Email body content. Supports HTML formatting

Response

ok · boolean

Whether the email was sent successfully

Request

curl -X POST \
  -H 'Authorization: <api_key>' \
  -H 'Content-Type: application/json' \
  'https://api.stormkit.io/v1/mailer' \
  -d '{
    "to": "[e-mail]",
    "from": "Jane Doe <[e-mail]>",
    "subject": "Hello Joe",
    "body": "Hi,<br/>How are you?"
  }'

---

Multiple Recipients

To send an email to multiple recipients, separate email addresses with semicolons:

{
  "to": "[e-mail]; [e-mail]; [e-mail]",
  "from": "[e-mail]",
  "subject": "Team Update",
  "body": "Hello team,<br/><br/>This is an important update."
}

HTML Email Body

The body field supports HTML content. The API automatically wraps your content in proper HTML structure:

{
  "to": "[e-mail]",
  "from": "[e-mail]",
  "subject": "Welcome to Our Service",
  "body": "<h1>Welcome!</h1><p>Thank you for signing up.</p><p><a href='https://example.org/verify'>Click here to verify your email</a></p>"
}

Error Responses

400 Bad Request

Returned when:

• Email body is empty
• Subject is empty
• Mailer is not configured for the environment

500 Internal Server Error

Returned when the SMTP server fails to send the email. The error message will contain details from the mail server.

Configuration

Before using this API endpoint, you must configure SMTP settings for your environment:

1. Navigate to your environment’s configuration
2. Set up your SMTP server details:
   • Host
   • Port (default: 587)
   • Username
   • Password

For detailed setup instructions, see the Mailer feature documentation.

Email Tracking

All emails sent through the Mailer API are stored in your environment’s database for tracking and audit purposes. This includes:

• Sender address
• Recipient address(es)
• Subject line
• Email body
• Timestamp