EmailSpace Documentation
EmailSpace is an AWS SES-first email template platform for product teams. Design templates in Template Studio, connect and verify AWS SES per project, publish templates to your AWS account, send from your application with the Node.js SDK, and run Automations and Campaigns from MongoDB or Excel.
Available today: project workspaces, Template Studio, AWS SES setup wizard, publish to SES, send via @emailspace/sdk, and data-driven Automations and Campaigns.
Four-step workflow
| Step | What you do | Where |
|---|---|---|
| 01 — Create a project | Sign up, verify your email, and create a project. Each project holds templates, components, globals, and SES credentials. | Dashboard → Projects |
| 02 — Design in Template Studio | Choose React Email or HTML. Use AI Builder or edit source directly. Add components, set sample variables, and preview across clients. | Project → Templates → Create |
| 03 — Connect AWS SES | Link your SES account per project. Credentials are encrypted; connection is verified against your AWS account. | Project → Email provider |
| 04 — Publish, send, and automate | Push templates to SES, send from your app with the Node.js SDK, or run Automations and Campaigns from your data. | Template Studio, your app, Automations tab |
Dashboard capabilities
Project workspaces
Each project is a self-contained workspace for one product or environment. Inside a project you manage:
- Templates — transactional and lifecycle email designs
- Components — reusable headers, footers, and blocks
- Global variables — brand name, support email, and other shared values
- Email provider — AWS SES connection and setup status
- Team members — invite collaborators per project
Template Studio
Template Studio is where you author email before anything reaches production.
| Capability | Description |
|---|---|
| React Email | Build with React Email components and live preview across clients |
| HTML | Import or write raw HTML with the same preview and publish flow |
| AI Builder | Generate and refine templates from a prompt in either editor |
| Source editor | Direct code editing with syntax highlighting (plan-gated) |
| Publish preview | Review compiled HTML, SES template name, subject line, and variable warnings before push |
Save a template before publishing. Publishing creates or updates an SES template in your connected AWS account.
Three variable layers
EmailSpace resolves three kinds of placeholders at different stages:
| Syntax | Layer | When resolved |
|---|---|---|
{{firstName}} | Runtime | At send time — pass values in data via the Node.js SDK |
{{&brandName}} | Project global | At publish time — inlined from project globals |
{{&@header}} | Component | At publish time — inlined from a reusable component slug |
Declare runtime variables in Template Studio so publish preview can warn about missing keys.
Reusable components
Build headers, footers, and blocks once under Project → Components. Insert them in templates with {{&@slug}}. On SES push, components are resolved and inlined into the final HTML.
Connect, verify, and go live
When you create a project, EmailSpace guides you through SES setup — or connects to an account where SES is already configured.
AWS account connect
Link your AWS account per project with encrypted credentials and live connection checks. Copy scoped IAM policies for:
- Guided setup — domain identity, DNS, and production access management
- Manage-only — template publish and send when SES is already configured in AWS
Dashboard: Project → Email provider → Configure AWS, or the SES setup wizard on first connect.
Domain and DNS verification
Register your sending domain in SES. EmailSpace shows verification and DKIM records to copy at your DNS provider.
- Check DNS — probe propagation from the wizard
- Confirm DNS — mark records as applied and refresh AWS status
- Route53 auto-configure — one-click DNS when the domain is hosted in Route53
Production access
Request SES production access (leave sandbox) from the wizard. In sandbox mode, only verified recipients and From addresses can receive mail.
Email identities
Add, verify, refresh, and remove sender addresses from Project → Email identities. Essential in SES sandbox — manage both domain-level and individual email identities.
Publish and send
After setup:
- Publish — push the template to SES
- Send from your app — use
@emailspace/sdk(Node.js SDK guide) - Send from dashboard — send test emails from Template Studio (when enabled on your plan)
Integration paths
Node.js SDK
Send templated email with @emailspace/sdk. Your app uses an EmailSpace API key — no AWS credentials required. Sends appear in Analytics → Messages automatically.
Best for: transactional email from your application (welcome emails, order confirmations, password resets).
AWS SES setup
Connect and verify AWS SES, publish templates, and manage email identities. Required before sending with the SDK.
Automations
Connect MongoDB or upload Excel/CSV. Send birthday wishes, onboarding reminders, and re-engagement when users go inactive — on a schedule, through SES.
Campaigns
One-off newsletters and promos to filtered audiences from the same data connections. Schedule or send immediately, then view an in-app performance report.
Prerequisites
Before sending from your app:
- Create a project in the EmailSpace dashboard
- Design a template in Template Studio and save it
- Connect AWS SES under Project → Email provider
- Publish the template to AWS SES
- Create an API key under Project → API credentials
Where to go next
- Node.js SDK — send from your app with
@emailspace/sdk - AWS SES guide — setup wizard, identities, and publish
- Automations — lifecycle email from MongoDB or Excel
- Campaigns — one-off broadcasts and performance reports