Mailrith Docs
Documentation
Step-by-step guides for every Mailrith feature — from connecting your first email delivery service to building multi-step automations.
Search results
Matching Articles
Getting Started
Sign-Up, Verification, and Access
Create an account, verify your email address, accept invitations, reset your password, and learn why a page or workspace may be unavailable.
Getting Started
Dashboard Overview
Use the setup cards and metric summary cards on the dashboard to check workspace health.
Getting Started
Workspaces
Create separate environments for different brands, clients, or teams. Each workspace has its own Subscribers, campaigns, forms, and permissions.
Getting Started
Account Settings
Update your personal profile and security, review the selected workspace owner's billing, manage workspace API keys, and find account deletion controls.
Getting Started
Billing and Plans
Understand trial and paid plan states, Solo, Pro, Agency, Agency add-ons, checkout, and subscription management.
Getting Started
API Keys and Authorized Apps
Create workspace API keys, choose read-only or read-write access, rotate or revoke keys, and review connected OAuth apps from Integrations.
Getting Started
Zapier
Connect Mailrith to Zapier so Zaps can update Subscribers, manage tags and sequences, and respond to signup, unsubscribe, bounce, and complaint events.
Subscriber Management
Subscribers
Add or import Subscribers, search and filter records, apply bulk updates, and review email, form, sequence, automation, and link history.
Subscriber Management
Subscriber Imports, Exports, and Bulk Actions
Prepare CSV files, map columns, run background import jobs, export filtered subscribers, and apply safe bulk actions.
Subscriber Management
Custom Fields
Create typed data fields for subscriber records, forms, segment conditions, automation logic, and email personalization.
Subscriber Management
Tags
Label subscribers with flexible, binary markers for targeting in broadcasts, sequences, automations, segments, and magic links.
Subscriber Management
Double Opt-In
Require confirmation emails for forms and landing pages, then save each Subscriber confirmation in the privacy history.
Subscriber Management
Segments
Build dynamic subscriber rules from status, tags, forms, sequences, and custom field values. Segments update automatically over time.
Forms & Landing Pages
Forms
Build embeddable signup forms with custom fields, tag assignment on submission, and either an inline success message or a redirect.
Forms & Landing Pages
Form Display Options
Choose inline, popup, slide-in, sticky bar, or full-page popup forms, then configure triggers, embed code, and HTML Code.
Forms & Landing Pages
Landing Pages
Build hosted landing pages with sections, blocks, forms, responsive settings, success pages, and 90-day performance reporting.
Forms & Landing Pages
Public Subscriber Experience
Learn what subscribers see when they submit forms, confirm subscriptions, click tracked links, or unsubscribe.
Forms & Landing Pages
Facebook Lead Ads
Use Facebook Lead Ads on any paid Mailrith plan to connect Pages, save form answers, add tags, start sequences, import older leads, and review activity.
Privacy And Compliance
GDPR FAQ
A resource for GDPR questions, Mailrith's GDPR consent tools, proof of consent, existing-list consent, privacy requests, and Subscriber deletion workflows.
Privacy And Compliance
CCPA: The California Consumer Privacy Act
What Mailrith customers need to know about California privacy rights, CCPA requests, DPA review, business purposes, and Subscriber data.
Campaigns & Delivery
Email Delivery Connections
Connect your email delivery service, set up the sender name and address, test delivery, and return bounce and complaint updates to Mailrith.
Campaigns & Delivery
Set Up Amazon SES
Connect Amazon SES to Mailrith with an IAM access key, a verified sender identity, and SNS webhook subscriptions for bounce and complaint tracking.
Campaigns & Delivery
Set Up Postmark
Connect a Postmark server to Mailrith with server and account API tokens, optional stream routing, and one webhook for bounce and complaint events.
Campaigns & Delivery
Set Up SendGrid
Connect SendGrid with an API key, then configure the Event Webhook to forward bounce and spam report events to Mailrith.
Campaigns & Delivery
Set Up Mailgun
Connect Mailgun with a sending key and verified domain, choose the correct region, and use one webhook endpoint for delivery event tracking.
Campaigns & Delivery
Set Up Resend
Connect Resend with an API key and verified domain, then add the Mailrith webhook so bounce and complaint updates reach the correct Subscribers.
Campaigns & Delivery
Set Up Brevo
Connect Brevo with an API key and verified sender, then add the Mailrith webhook so bounce and spam complaint updates reach the correct Subscribers.
Campaigns & Delivery
Set Up Custom SMTP
Connect an email delivery service with its host, port, security mode, and login details when Mailrith does not have a built-in connection.
Campaigns & Delivery
Email Editor
Use Mailrith's editor to add text, sections, images, buttons, templates, personalization, previews, autosave, and test sends.
Campaigns & Delivery
Email Templates
Build and share reusable email layouts so broadcasts and sequence emails can use the same visual structure without rebuilding the layout for each message.
Campaigns & Delivery
Broadcasts
Compose one-off email campaigns, select subscribers with tags and segments, preview the email, and send the campaign now or schedule the campaign for later.
Automation
Sequences
Build timed email series with delays for each email, subscriber filters for each email, draft and publish controls, and engagement analytics for each step.
Automation
Magic Links
Generate trackable URLs that apply tag and sequence actions to a subscriber when the subscriber clicks the link in an email.
Automation
Automations
Build visual automations with triggers, waits, conditions, and actions that run when Subscribers match your rules.
AI Writing
AI Connections
Connect OpenAI, Claude, or OpenRouter, assign provider accounts to workspaces, choose default models, and repair failed connections.
AI Writing
AI Writing
Use AI to draft broadcasts, sequence emails, full sequence ladders, and automation ideas. Review and approve the generated content before you use it.
Team Management
Team Members
Invite team members, assign workspaces, and choose feature permissions so each person can access only what they need.
Developer Docs / Getting Started
Quickstart
Create a workspace key and make your first authenticated request to Mailrith's public API.
Developer Docs / Getting Started
Authentication
Use workspace-scoped Bearer keys and learn how Mailrith authorizes protected requests.
Developer Docs / Getting Started
Testing the API
Run the local worker, generate a workspace key, call the endpoints, and run automated integration coverage.
Developer Docs / Getting Started
Agents
Discover Mailrith from agent runtimes with llms files, API metadata, OpenAPI, and authenticated capability discovery.
Developer Docs / Getting Started
SDKs
Use the official TypeScript and Python SDKs generated from Mailrith's public contract.
Developer Docs / Getting Started
MCP Server
Connect Mailrith to agent runtimes through the official remote MCP server and streamable HTTP transport.
Developer Docs / Getting Started
Zapier
Build, test, and publish the official Mailrith Zapier Platform CLI integration.
Developer Docs / API Concepts
Pagination
Page through large list endpoints safely with cursors, saved progress, and reusable sync loops.
Developer Docs / API Concepts
Errors
Read Mailrith error envelopes, map status codes to behavior, and decide when retrying a request is safe.
Developer Docs / API Concepts
Idempotency
Retry import and export job creation safely with the `Idempotency-Key` header.
Developer Docs / API Concepts
Versioning
Pin clients to the `/v1` path contract and plan future upgrades with the OpenAPI document.
Developer Docs / API Concepts
Consent And Privacy API Boundaries
Understand which Subscriber privacy fields the public API accepts and when to use Mailrith-hosted consent workflows instead.
Developer Docs / API Resources
Subscribers API
List and upsert subscribers with practical guidance for identity, tags, fields, syncs, and imports.
Developer Docs / API Resources
Tags API
Use tags as clear labels on subscriber records for targeting, forms, imports, and automation conditions.
Developer Docs / API Resources
Custom Fields API
Manage typed subscriber fields before you sync field values, forms, segments, or migrated subscriber data.
Developer Docs / API Resources
Forms API
Manage Mailrith capture forms from external form builders, migrations, and admin tools.
Developer Docs / API Resources
Landing Pages API
Manage Mailrith-hosted landing pages, page definitions, settings, and public URLs.
Developer Docs / API Resources
Broadcasts API
Create campaign drafts, send test emails, and require deliberate approval before live broadcast sends.
Developer Docs / API Resources
Email Templates API
Manage reusable email templates, structured editor content, and approved layout libraries.
Developer Docs / API Resources
Sequences API
Manage timed email series for onboarding, nurture, migration, and lifecycle workflows.
Developer Docs / API Resources
Automations API
Manage automation definitions with triggers, branches, actions, conditions, and review safeguards.
Developer Docs / API Resources
Magic Links API
Create and maintain email links that perform clear subscriber actions when clicked.
Developer Docs / API Resources
Segments API
Manage saved subscriber rules and preview unsaved segment definitions before saving or sending.
Developer Docs / API Resources
Import and Export Jobs
Create async subscriber import and export jobs, use idempotency, and monitor job status until completion.
Developer Docs / API Resources
Webhook Subscriptions API
Create signed event subscriptions for CRMs, dashboards, audits, and workflow systems.
Developer Docs / API Reference
API Reference
Browse generated endpoint details and download the exact OpenAPI contract for tooling.
Guides / Start Here
What Sending an Email Means
Mailrith prepares the campaign, your email delivery service sends the email, and inbox providers decide where the message lands.
Guides / Start Here
Email Types and Sender Separation
Marketing, transactional, operational, and personal email should not always use the same sender setup.
Guides / Start Here
Choose the Right Sending Method
Use broadcasts for one-time messages, sequences for planned follow-ups, and automations for behavior-based journeys.
Guides / Start Here
Plan Before You Write
A short plan keeps the email focused and prevents last-minute mistakes with subscribers, the offer, and timing.
Guides / Setup and Permission
Prepare the Sender Identity
Choose a sender name, sender email, reply-to address, and verified domain that match the trust you want subscribers to have in your email.
Guides / Setup and Permission
Keep Permission and Compliance Simple
Send to people who expect your email, identify yourself clearly, and make unsubscribing easy.
Guides / Setup and Permission
Protect List Quality
A smaller list of people who want your emails is better than a large list of people who ignore or reject your emails.
Guides / Setup and Permission
Email Delivery Services
An email delivery service sends your email, while Mailrith manages subscribers, campaigns, and follow-up.
Guides / Setup and Permission
Connect and Test an Email Delivery Connection
Create a Mailrith delivery connection, save the email delivery service credentials, assign the connection to the correct workspace, and send a test email.
Guides / Authentication and Deliverability
Sender Domains and Email Authentication
Your sender domain is what inbox providers learn to trust. Authentication proves that your email delivery service is allowed to send email for your domain.
Guides / Authentication and Deliverability
From, Reply-To, and Return-Path
An email can include several sender-related addresses. Each address has a separate role for delivery, authentication, or replies.
Guides / Authentication and Deliverability
DNS, PTR, and Reverse DNS
DNS records identify your domain. Reverse DNS helps inbox providers check that a sending IP address has a valid hostname.
Guides / Authentication and Deliverability
Email Headers and Message Format
Message headers, MIME structure, and basic formatting rules help inboxes read, display, and trust an email.
Guides / Authentication and Deliverability
SPF
SPF is a DNS record that lists the servers and services that may send email for your domain.
Guides / Authentication and Deliverability
DKIM
DKIM adds a signature to each email so inboxes can confirm that an approved domain accepted responsibility for the message.
Guides / Authentication and Deliverability
DMARC
DMARC tells inboxes how to handle a message that uses your domain but does not pass aligned SPF or DKIM checks.
Guides / Authentication and Deliverability
DMARC Alignment
DMARC alignment checks whether SPF or DKIM authentication uses the same domain family as the domain subscribers see in the From address.
Guides / Authentication and Deliverability
TLS and Secure Sending
TLS encrypts email while it moves between mail systems. Bulk senders are now expected to use TLS.
Guides / Authentication and Deliverability
MTA-STS and TLS Reporting
MTA-STS and TLS reporting are advanced controls for domains that need stronger protection for inbound email transport.
Guides / Authentication and Deliverability
ARC and Forwarded Email
ARC helps forwarding services preserve email authentication results when forwarding breaks SPF or changes a message.
Guides / Authentication and Deliverability
Sender Reputation and Spam Rate
Sender reputation is the trust inbox providers build from your authentication, sending history, volume, complaints, and subscriber behavior.
Guides / Authentication and Deliverability
Dedicated and Shared Sending IPs
Shared IPs let many senders use the same sending infrastructure. Dedicated IPs place more reputation responsibility on one sender.
Guides / Authentication and Deliverability
Sending Volume and Warmup
New senders should build trust gradually instead of sending a large campaign right away.
Guides / Authentication and Deliverability
Blocklists and Link Reputation
Inbox providers may distrust a sender because of the sending IP, domain, email delivery service account, or links in the email.
Guides / Authentication and Deliverability
Tracking Domains, Links, and UTMs
Open tracking, click tracking, tracking domains, and UTM fields affect reporting. They can also affect whether subscribers trust your email.
Guides / Authentication and Deliverability
Inbox Placement, Promotions, and Spam Folders
Delivery means the receiving system accepted the message. Placement means where the inbox shows the message.
Guides / Authentication and Deliverability
One-Click Unsubscribe and Opt-Outs
Marketing emails should make unsubscribing easy. Bulk sender rules also expect fast, simple unsubscribe handling.
Guides / Authentication and Deliverability
Bounces
A bounce means an email could not be delivered. Repeatedly sending to bad addresses can hurt future delivery.
Guides / Authentication and Deliverability
Spam Complaints
A complaint means a subscriber marked your email as spam. Inbox providers treat complaints as one of the strongest negative signals.
Guides / Authentication and Deliverability
Complaint Feedback Loops and ARF
Feedback loops tell senders when subscribers mark email as spam. These reports usually come from an email delivery service or mailbox provider.
Guides / Authentication and Deliverability
Suppression Lists and Subscriber Status
Suppression protects people who should not receive normal marketing email, including unsubscribed, bounced, or complained subscribers.
Guides / Authentication and Deliverability
BIMI
BIMI can show a brand logo in some inboxes, but logo display depends on strong authentication and inbox support.
Guides / Subscribers
Build the Subscriber List
Subscribers are people, tags describe subscribers, custom fields store subscriber details, and segments choose who matches the rules today.
Guides / Subscribers
Use Segments and Exclusions
Include the people who should receive the email, and exclude the people who should not receive it.
Guides / Message
Write the Subject and Preview Text
The subject gets attention. The preview text gives subscribers another reason to open the email.
Guides / Message
Write the Email Body
A good email has one main point, enough context, and one clear next step.
Guides / Message
Design for Phones First
Most subscribers scan emails quickly, so the email must be easy to read on a small screen.
Guides / Message
Use Personalization Carefully
Personalization works well when subscriber data is reliable. It feels awkward when subscriber data is missing or wrong.
Guides / Send and Schedule
Choose Delivery Settings
The delivery connection, reply-to address, tracking, UTM fields, and schedule should match the campaign purpose.
Guides / Send and Schedule
Test Like a Subscriber
Test an email like a Subscriber by opening, reading, and clicking it on desktop and mobile before you send.
Guides / Send and Schedule
Send Now or Schedule
Send a campaign immediately only after the email, subscriber list, send time, and approvals are final.
Guides / Learn and Fix
Read the Results
After a campaign sends, review delivery, opens, clicks, unsubscribes, bounces, and complaints together.
Guides / Learn and Fix
Handle Bounces, Complaints, and Unsubscribes
Delivery events help protect future sends by keeping risky addresses out of normal campaigns.
Guides / Learn and Fix
SMTP Errors, Deferrals, and Throttling
SMTP errors and email delivery service responses show whether a delivery problem is temporary, permanent, or caused by rate limits.
Guides / Learn and Fix
Troubleshooting Common Sending Problems
You can narrow down most sending issues by checking setup, subscribers, content, email delivery service, and subscriber status.
Guides / Learn and Fix
Improve the Next Email
Use each email send to learn one useful lesson and make the next campaign clearer.
No Matching Docs
Try a different keyword — for example, a provider name, feature area, or action like "import" or "schedule".