Documentation

Everything you need to integrate MailFabric into your application. From quick start guides to complete API reference.

Quick Start

Get up and running with MailFabric in three simple steps.

1

Create API Key

Generate an API key from your dashboard to authenticate requests.

# Navigate to Dashboard > Settings > API Keys
# Click "Create New Key"
# Copy your key — it won't be shown again

export MAILFABRIC_API_KEY="mf_live_..."
2

Verify Domain

Add and verify your sending domain with DNS records.

curl -X POST https://api.mailfabric.io/v1/domains \
  -H "Authorization: Bearer $MAILFABRIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com"}'
3

Send First Email

Send your first transactional email via the API.

curl -X POST https://api.mailfabric.io/v1/emails \
  -H "Authorization: Bearer $MAILFABRIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example.com",
    "from": "hello@example.com",
    "subject": "Welcome!",
    "html": "<h1>Hello World</h1>"
  }'

API Reference

The MailFabric REST API uses standard HTTP methods with JSON request and response bodies. All endpoints require authentication via Bearer token.

Base URL

https://api.mailfabric.io

Email Sending

POST/v1/emailsSend a single email
POST/v1/emails/batchSend batch emails
GET/v1/emails/:idGet email details
GET/v1/emails/:id/eventsGet email events

Templates

GET/v1/templatesList templates
POST/v1/templatesCreate template
PUT/v1/templates/:idUpdate template
POST/v1/templates/:id/renderRender template

Domains

GET/v1/domainsList domains
POST/v1/domainsAdd domain
POST/v1/domains/:id/verifyVerify domain
DELETE/v1/domains/:idRemove domain

Webhooks

GET/v1/webhooksList webhooks
POST/v1/webhooksCreate webhook
PUT/v1/webhooks/:idUpdate webhook
POST/v1/webhooks/:id/testTest webhook

Analytics

GET/v1/analytics/summaryGet analytics summary
GET/v1/analytics/timelineGet timeline data
GET/v1/analytics/by-domainAnalytics by domain
GET/v1/analytics/by-templateAnalytics by template

SDKs

Official client libraries are on the way. We're building first-class SDKs for the most popular languages.

Node.js

Coming Soon
@mailfabric/node

Go

Coming Soon
github.com/TruSpec-Virtual-Solutions/mailfabric-go

Python

Coming Soon
mailfabric

.NET

Coming Soon
MailFabric.Net

SDKs are in active development. In the meantime, you can use our REST API directly with any HTTP client.

Need help?

If you run into any issues or have questions, reach out to our developer support team at support@mailfabric.io or join our developer community.

MailFabric
© Copyright 2026 TruSpec Virtual Solutions, LLC. All rights reserved.