EYMINT
DocumentationAPI Reference
BlogDashboard
EYMINT
SectionsDocumentationAPI Reference
Go to Dashboard

For AI agents: the documentation index is at /llms.txt. Every docs page is also available as markdown by adding .md to its URL.

Getting Started

  • Keymint Documentation
  • Introduction
  • Getting Started
  • License Keys
  • Changelog

SDK References

  • Software Development Kits (SDKs)
  • Node.js SDK
  • Go SDK
  • Python SDK
  • C# SDK

Integration Guides

  • Integration Guides
  • Customer Portal for Vendors
  • Roles & Permissions
  • Radar Alert Destinations
  • Payment Provider Integrations
  • Stripe Subscription Licensing
  • Import Existing License Keys
  • Email Delivery
  • API Key Management
  • Webhook Deliveries
  • Analytics and Retention
  • Dashboard Workflows
  • Electron Licensing
  • PyQt Licensing
  • Tauri Licensing
  • Next.js SaaS Licensing

Licensing Guides

  • Licensing Concepts
  • Node-Locking & Machine Identifiers
  • Floating Licenses
  • Offline Verification
  • License Radar
  • Public Key Management and Rotation
  • Feature Flags
  • Webhooks & Events

Templates

  • Starter Templates
  • Electron License Starter
  • PyQt License Starter
  • Tauri License Starter
  • Next.js SaaS License Starter

Security & Trust

  • Security & Trust

Support

  • Frequently Asked Questions
  • Customer Portal
  • Using the Customer Portal
  • Workspace Settings and Roles

Legal

  • Privacy Policy
  • Subprocessors
  • Data Processing Agreement
  • Security Overview
  • Terms of Service
  • Service Level Agreement (SLA)
  • GDPR Compliance

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

ProviderConfigurationUse Case
Keymint ManagedZero config. Sends from no-reply@keymint.devFastest setup. Ideal for teams that don't need custom branding.
Custom SMTPSMTP host, port, credentialsFull control over sender email, domain, and routing.

Email Variables

The following variables are available in your subject line and HTML template:

VariableDescription
{{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)

FieldRequiredDescription
SMTP HostYesYour SMTP server hostname
PortYes25, 465 (SSL), 587 (STARTTLS) or 2525; other ports are refused
Secure ConnectionRecommendedEnable SSL/TLS
UsernameYesSMTP authentication username
PasswordYesSMTP authentication password

Use the Test Connection button to verify your SMTP credentials before saving.

4. Sender Identity

FieldPlan RequirementDescription
Sender NameStandardDisplay name. Defaults to "Keymint Delivery".
Sender EmailCustom SMTP onlyFrom address. Keymint Managed uses no-reply@keymint.dev.
Subject LineStandardEmail 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.

html
<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

FeatureFreeStartupStandard
Email Delivery✅✅✅
Custom SMTP❌❌✅
HTML Template Customization❌❌✅
Sender Identity Customization❌❌✅
License emails per day1005,00025,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.

On this page

  • Overview
  • Key Features
  • How It Works
  • Delivery Providers
  • Email Variables
  • Configuration
  • 1. Enable Delivery
  • 2. Choose Provider
  • 3. SMTP Configuration (Custom SMTP Only)
  • 4. Sender Identity
  • 5. HTML Template
  • 6. Delivery Triggers
  • Per-Product Settings
  • Abuse Prevention
  • Template Security
  • Plan Limits
  • Daily limit
  • Suppressed addresses
  • Resending
  • Testing
  • SMTP Connection Test
  • Test Email
  • API Integration