Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.insforge.dev/llms.txt

Use this file to discover all available pages before exploring further.

Email is a private preview feature. APIs and behavior may change.

​
Overview

InsForge provides a managed email service for sending transactional emails. By default, mail is delivered through InsForge Cloud (built on AWS SES) for high deliverability without infrastructure setup. You can also configure a custom SMTP server to send through your own provider — the same API powers both paths.

​
Technology Stack

​
How It Works

  1. SDK Call - Your application calls emails.send() with recipients and HTML content
  2. API Processing - Request is validated and authenticated
  3. Provider Resolution - EmailService checks per-call whether custom SMTP is enabled
  4. Delivery - The email is queued through AWS SES (cloud) or your SMTP server, then delivered to the recipient

​
Key Features

High Deliverability

AWS SES infrastructure with optimized sending reputation

Custom SMTP

Bring your own SMTP server and route every email — including auth flows — through your provider

Multiple Recipients

Send to up to 50 recipients per request with CC/BCC support

Custom Sender

Customize the sender display name for your brand

Editable Templates

With custom SMTP enabled, customize the subject and HTML of every authentication email

HTML Content

Full HTML email support for rich formatting

​
Rate Limits

PlanLimit
Starter10 emails per hour
Pro50 emails per hour
Custom transactional emails require a paid plan. Authentication emails (verification, password reset) are included in all plans.

​
Best Practices

Validate Recipients

Verify email addresses before sending to maintain deliverability

Meaningful Content

Send relevant, expected emails to avoid spam reports

Handle Errors

Always check the error response and handle failures gracefully

Respect Limits

Implement queuing for bulk sends to stay within rate limits

​
SDK References

TypeScript

Send transactional emails from web and Node.js applications
Email SDK is currently only available for TypeScript as part of the TypeScript SDK. Mobile SDKs (Swift, Kotlin) support for email is coming soon.