Email Delivery
Configure Keymint email delivery for new license keys with managed delivery, custom SMTP, branded HTML templates, sender identity, and delivery triggers.
Overview
Keymint's Email Delivery Engine automatically sends professional, branded license key emails to your customers the moment a license key is generated — via the dashboard or the API. No integration required.
Key Features
- Zero-config managed delivery — Keymint handles delivery infrastructure, reputation, and abuse prevention.
- Custom SMTP — Bring your own mail server for full control over sender identity and routing.
- HTML templates — Design rich email templates with variable interpolation and a live preview editor.
- Plan-based access — Features are gated by subscription tier (Sender identity, HTML customization, and SMTP).
How It Works
When a license key is generated (either via the dashboard or the REST API), Keymint compiles your HTML template with the customer and license data, then delivers the email through your chosen provider.
Delivery Providers
| Provider | Configuration | Use Case |
|---|---|---|
| Keymint Managed | Zero config. Sends from no-reply@keymint.dev | Fastest setup. Ideal for teams that don't need custom branding. |
| Custom SMTP | SMTP host, port, credentials | Full control over sender email, domain, and routing. |
Email Variables
The following variables are available in your subject line and HTML template:
| Variable | Description |
|---|---|
{{customer_name}} | The customer's full name |
{{customer_email}} | The customer's email address |
{{product_name}} | The product the license is associated with |
{{license_key}} | The generated license key string |
{{expiry_date}} | The license expiration date (if applicable) |
{{max_activations}} | The maximum number of device activations |
Configuration
Email delivery settings are configured per workspace under Developer → Email Delivery.
1. Enable Delivery
Toggle on the global Enable Email Delivery switch to activate automated sending.
2. Choose Provider
Select Keymint Managed for zero configuration, or Custom SMTP to route through your own infrastructure.
3. SMTP Configuration (Custom SMTP Only)
| Field | Required | Description |
|---|---|---|
| SMTP Host | Yes | Your SMTP server hostname |
| Port | Yes | 25, 465 (SSL), 587 (STARTTLS) or 2525; other ports are refused |
| Secure Connection | Recommended | Enable SSL/TLS |
| Username | Yes | SMTP authentication username |
| Password | Yes | SMTP authentication password |
Use the Test Connection button to verify your SMTP credentials before saving.
4. Sender Identity
| Field | Plan Requirement | Description |
|---|---|---|
| Sender Name | Standard | Display name. Defaults to "Keymint Delivery". |
| Sender Email | Custom SMTP only | From address. Keymint Managed uses no-reply@keymint.dev. |
| Subject Line | Standard | Email subject. Supports {{product_name}} variable. |
5. HTML Template
Available on Standard plan and above. Use the tabbed editor to write custom HTML with live preview using mock data.
<div style="font-family: Arial, sans-serif; max-width: 600px; margin: auto;">
<h2>Your License Key for {{product_name}}</h2>
<p>Hi {{customer_name}},</p>
<p>Here is your license key: <strong>{{license_key}}</strong></p>
<p>Expires: {{expiry_date}}</p>
</div>6. Delivery Triggers
Toggle whether emails are sent when keys are generated:
- Via API — Triggered when a key is created through the REST API.
- Via Dashboard — Triggered when a key is created from the dashboard UI.
Per-Product Settings
Every product follows the workspace defaults above unless you customize it. To see which products do, open Developer → Email delivery → Products: each product shows Workspace defaults or Custom, with the settings it changes.
To customize one product, select it in that list, then choose Customize for this product. The form starts from the workspace's current settings; anything you leave empty (sender, subject, template) still follows the workspace defaults. Use workspace defaults switches the product back without deleting its custom values, so customizing again restores them.
Abuse Prevention
When using the Keymint Managed provider, emails pass through automated abuse prevention:
- Brand Blocklist — Sender names and subject lines containing major brand trademarks or phishing-related keywords are flagged.
- Mandatory Footer — All Keymint-managed emails include an abuse reporting footer for recipients.
Template Security
Custom HTML templates are sanitized before compilation:
- Sanitizer — Templates are parsed and sanitized with DOMPurify (not regex): scripts, iframes, event handlers, SVG/SMIL payloads, and
javascript:/data:URI schemes (including entity-encoded variants) are removed. Templates containing<style>blocks may lose styling. - Variable escaping — Template variables (
{{customer_name}},{{product_name}}, etc.) are HTML-escaped before interpolation, so user-supplied values are always rendered as plain text. - Preview sandbox — The dashboard preview iframes run with
sandbox="", so even a malformed template cannot execute scripts in the dashboard session. - Custom SMTP — SMTP hosts must be public hostnames. Hosts that resolve to private, loopback or internal addresses are rejected, and only the standard mail ports (25, 465, 587, 2525) are allowed.
These measures protect the shared sending domain's deliverability reputation for all customers.
Plan Limits
| Feature | Free | Startup | Standard |
|---|---|---|---|
| Email Delivery | ✅ | ✅ | ✅ |
| Custom SMTP | ❌ | ❌ | ✅ |
| HTML Template Customization | ❌ | ❌ | ✅ |
| Sender Identity Customization | ❌ | ❌ | ✅ |
| License emails per day | 100 | 5,000 | 25,000 |
Daily limit
Each workspace can send a limited number of license emails per day. The count resets at 00:00 UTC. It includes every license email: delivery when a key is created (dashboard or API), offline-license emails and resends. One email that carries several keys counts once. Custom SMTP sends count too.
When the limit is reached, Keymint stops sending license emails for the rest of the day. License creation, activation and the rest of the API keep working; only the email is skipped. Each skipped email appears in Developer → Email delivery → Delivery activity as Daily limit, and you can resend it from the license once the limit resets.
Suppressed addresses
Keymint's mail service does not send license emails to an address that has hard-bounced or has reported a Keymint email as spam. These emails are skipped and appear in Delivery activity as Suppressed, so a bad address does not keep bouncing. The customer's page shows why their address is blocked.
- Bounced: if the customer has fixed their mailbox, an Owner or Admin can click Allow emails again on the customer's page. Each address can be re-enabled once every 30 days; if it bounces again, ask the customer for a working address.
- Reported as spam: this is the recipient's choice, so it can't be undone from the dashboard. To reach that customer, update their email address.
This only applies to emails Keymint sends. If you send through your own SMTP server, Keymint doesn't block any address; your mail provider handles bounces and complaints.
Resending
You can resend a license email from the Licenses list (select the keys, then Actions → Resend delivery email) or from a license's own page (⋯ → Resend delivery email).
- Each license can be resent once every 10 minutes.
- Resend to all matching licenses can be used 10 times an hour per workspace.
Over these limits the dashboard shows a message telling you when you can try again.
Testing
SMTP Connection Test
Verify your SMTP credentials are valid before enabling delivery. The test opens a connection to your server, attempts authentication, and reports success or specific failure details.
Test Email
Send a sample email to your configured sender email address using the current template and settings. This confirms end-to-end delivery without creating a real license key.
API Integration
Email delivery is triggered automatically when license keys are generated via the REST API — no special flag needed. Delivery behavior is controlled by the Delivery triggers settings for your workspace:
- Via API — Enabled by default. Toggle off to prevent email sending for API-generated keys.
- Via Dashboard — Enabled by default. Toggle off to prevent email sending for dashboard-generated keys.
The standard Create License Key endpoint requires no additional parameters. Email delivery follows your workspace's configuration automatically.