# Mailrith

> Mailrith is a fixed-price email marketing platform for solopreneurs. Public paid plans include unlimited subscribers, visual automations, hosted forms and landing pages, AI-assisted drafting, a public API, official SDKs, and an official MCP server for agent runtimes.

Use the linked markdown files when you need clean context. Use the OpenAPI document for exact request and response schemas. Use authenticated capability discovery before issuing write requests because capabilities depend on the workspace key.

Important interpretation notes:
- Mailrith sends through customer-chosen email delivery services; agents should not assume Mailrith is an inbox or the service that delivers the email.
- Public API keys are workspace-scoped. Do not add a separate workspace identifier unless the documented endpoint asks for one.
- Resource permissions are consistent: a write permission covers every public write operation for that resource. Limit the tools available to an agent when a workflow should use only a subset.
- Public form, landing-page success, status, and non-production pages are intentionally non-indexable.

## Core Resources
- [Product overview markdown](https://mailrith.com/index.md): Mailrith is fixed-price email marketing with Subscribers, campaigns, automations, landing pages, and customer-chosen email delivery services. The page explains the main product areas and primary workflows.
- [Pricing markdown](https://mailrith.com/pricing.md): Plain-language summary of the configured public plans, plus the savings calculator context when a monthly Solo price is available.
- [Privacy Policy markdown](https://mailrith.com/privacy-policy.md): How Mailrith handles account, workspace, and Subscriber information.
- [Terms of Service markdown](https://mailrith.com/terms-of-service.md): Rules for using Mailrith, including accounts, billing, Subscriber data, email sending, connected providers, APIs, and acceptable use.
- [Features And Support For The General Data Protection Regulation (GDPR) And California Consumer Privacy Act (CCPA) markdown](https://mailrith.com/gdpr.md): Overview of Mailrith privacy features, consent settings, Subscriber request support, DPA review, audit support, and international transfer resources for GDPR and CCPA workflows.
- [Mailrith Data Processing Addendum markdown](https://mailrith.com/dpa.md): Processor terms for Mailrith's processing of Customer-controlled Subscriber Personal Data under Customer instructions.
- [Mailrith Security markdown](https://mailrith.com/security.md): Security information for Mailrith safeguards, customer responsibilities, vulnerability reports, and incident notices.
- [Mailrith Imprint markdown](https://mailrith.com/imprint.md): Operator, mailing address, customer support contact, and legal contact for Mailrith.
- [User docs markdown index](https://mailrith.com/docs/index.html.md): All user help categories and article summaries.
- [Developer docs markdown index](https://mailrith.com/developers/index.html.md): All developer documentation categories and article summaries.
- [Email sending guides markdown](https://mailrith.com/guides/index.html.md): Plain-language guide to planning, writing, testing, sending, and improving emails.
- [Free email tools markdown](https://mailrith.com/free-tools/index.html.md): Free tools for email address checks, bulk list cleanup, real deliverability testing, sender-domain health, DNS authentication, SPF, DKIM, DMARC, BIMI, MTA-STS, TLS reporting, SMTP TLS readiness, PTR, IP reputation, headers, unsubscribe headers, links, subject lines, preview text, HTML size, and spam-content review.
- [Features markdown](https://mailrith.com/features/index.html.md): Practical map of Mailrith's main features, including guidance for choosing and connecting Amazon SES, Postmark, SendGrid, Mailgun, Resend, Brevo, or Custom SMTP.
- [Use cases markdown](https://mailrith.com/use-cases/index.html.md): Email marketing use cases for specific teams and business types.
- [Unlimited Subscribers feature markdown](https://mailrith.com/features/unlimited-subscribers.md): Mailrith Unlimited Subscribers lets you grow your list without per-subscriber Mailrith pricing. Keep tags, fields, segments, forms, and emails in one place.
- [Workspaces feature markdown](https://mailrith.com/features/workspaces.md): Mailrith Workspaces keep brands, clients, or projects separate with their own subscribers, emails, forms, automations, delivery connections, and team access.
- [Email Delivery Connections feature markdown](https://mailrith.com/features/email-delivery-connections.md): Mailrith Email Delivery Connections let you use Amazon SES, Postmark, SendGrid, Mailgun, Resend, Brevo, or Custom SMTP while Mailrith manages subscribers and emails.
- [AI Writing feature markdown](https://mailrith.com/features/ai-writing.md): Mailrith AI Writing helps draft broadcasts, sequence emails, sequence plans, and automation ideas. Review each draft before anything goes live.
- [AI Agents feature markdown](https://mailrith.com/features/ai-agents.md): Explore Mailrith's AI Agent workflows with OAuth, MCP, SDKs, scoped tools, and dedicated test-workspace guidance.
- [Landing Pages feature markdown](https://mailrith.com/features/landing-pages.md): Mailrith Landing Pages let you build hosted signup pages with forms, page sections, success pages, and reporting.
- [Forms feature markdown](https://mailrith.com/features/forms.md): Mailrith Forms let you build signup forms, collect subscriber details, assign tags, and embed the form on your website.
- [Magic Links feature markdown](https://mailrith.com/features/magic-links.md): Mailrith Magic Links turn a subscriber click into actions such as tagging, sequence enrollment, and simple preference updates.
- [Automations feature markdown](https://mailrith.com/features/automations.md): Mailrith Automations help you build subscriber follow-up with triggers, waits, rules, emails, tags, and sequences.
- [Sequences feature markdown](https://mailrith.com/features/sequences.md): Mailrith Sequences send planned emails to subscribers over time for welcome emails, onboarding, and educational follow-up.
- [Broadcasts feature markdown](https://mailrith.com/features/broadcasts.md): Mailrith Broadcasts help you write, select subscribers, test, schedule, send, and review one-time emails.
- [Tags feature markdown](https://mailrith.com/features/tags.md): Mailrith Tags help organize subscribers by source, interest, stage, behavior, and email sending rules.
- [Custom Fields feature markdown](https://mailrith.com/features/custom-fields.md): Mailrith Custom Fields store subscriber details for personalization, segments, forms, imports, and automation rules.
- [Segments feature markdown](https://mailrith.com/features/segments.md): Mailrith Segments creates reusable subscriber groups from tags, custom fields, status, forms, sequences, and activity rules.
- [Team Management feature markdown](https://mailrith.com/features/team-management.md): Mailrith Team Management lets you invite teammates, assign workspace access, and manage permissions without sharing passwords.
- [Email Delivery Service Guides](https://mailrith.com/features/index.html.md): Guides for choosing and connecting Amazon SES, Postmark, SendGrid, Mailgun, Resend, Brevo, or Custom SMTP.
- [Amazon SES Email Marketing setup markdown](https://mailrith.com/features/amazon-ses-email-marketing.md): Use Mailrith with Amazon SES for email marketing campaigns, newsletters, forms, automations, and reports while Amazon SES handles delivery.
- [Custom SMTP Email Marketing setup markdown](https://mailrith.com/features/custom-smtp-email-marketing.md): Use Custom SMTP with Mailrith to connect an email delivery service for newsletters, campaigns, sequences, automations, and reports.
- [Postmark Email Marketing setup markdown](https://mailrith.com/features/postmark-email-marketing.md): Postmark Email Marketing with Mailrith: run campaigns, newsletters, forms, automations, and reports while Postmark handles delivery.
- [SendGrid Email Marketing setup markdown](https://mailrith.com/features/sendgrid-email-marketing.md): SendGrid Email Marketing with Mailrith: run campaigns, newsletters, forms, automations, and reports while SendGrid handles delivery.
- [Mailgun Email Marketing setup markdown](https://mailrith.com/features/mailgun-email-marketing.md): Mailgun Email Marketing with Mailrith: run campaigns, newsletters, forms, automations, and reports while Mailgun handles delivery.
- [Resend Email Marketing setup markdown](https://mailrith.com/features/resend-email-marketing.md): Resend Email Marketing with Mailrith: run campaigns, newsletters, forms, automations, and reports while Resend handles delivery.
- [Brevo Email Marketing setup markdown](https://mailrith.com/features/brevo-email-marketing.md): Brevo Email Marketing with Mailrith: run campaigns, newsletters, forms, automations, and reports while Brevo handles delivery.
- [Email Marketing For Coaches markdown](https://mailrith.com/use-cases/coaches.md): Email marketing for coaches with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Course Creators markdown](https://mailrith.com/use-cases/course-creators.md): Email marketing for course creators with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Bloggers markdown](https://mailrith.com/use-cases/bloggers.md): Email marketing for bloggers with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Newsletter Creators markdown](https://mailrith.com/use-cases/newsletter-creators.md): Email marketing for newsletter creators with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Digital Product Creators markdown](https://mailrith.com/use-cases/digital-product-creators.md): Email marketing for digital product creators with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For WordPress Websites markdown](https://mailrith.com/use-cases/wordpress-websites.md): Email marketing for WordPress websites with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Content Creators markdown](https://mailrith.com/use-cases/content-creators.md): Email marketing for content creators with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Authors markdown](https://mailrith.com/use-cases/authors.md): Email marketing for authors with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Podcasters markdown](https://mailrith.com/use-cases/podcasters.md): Email marketing for podcasters with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For YouTubers markdown](https://mailrith.com/use-cases/youtubers.md): Email marketing for YouTubers with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Small Businesses markdown](https://mailrith.com/use-cases/small-businesses.md): Email marketing for small businesses with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Marketing Consultants markdown](https://mailrith.com/use-cases/marketing-consultants.md): Email marketing for marketing consultants with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Indie Developers markdown](https://mailrith.com/use-cases/indie-developers.md): Email marketing for indie developers with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Real Estate Agents markdown](https://mailrith.com/use-cases/real-estate-agents.md): Email marketing for real estate agents with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Event Organizers markdown](https://mailrith.com/use-cases/event-organizers.md): Email marketing for event organizers with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Gyms markdown](https://mailrith.com/use-cases/gyms.md): Email marketing for gyms with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Law Firms markdown](https://mailrith.com/use-cases/law-firms.md): Email marketing for law firms with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Startups markdown](https://mailrith.com/use-cases/startups.md): Email marketing for startups with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Web Design Agencies markdown](https://mailrith.com/use-cases/web-design-agencies.md): Email marketing for web design agencies with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For SEO Agencies markdown](https://mailrith.com/use-cases/seo-agencies.md): Email marketing for SEO agencies with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Digital Marketing Agencies markdown](https://mailrith.com/use-cases/digital-marketing-agencies.md): Email marketing for digital marketing agencies with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For SaaS Companies markdown](https://mailrith.com/use-cases/saas.md): Email marketing for SaaS with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Nonprofit Organizations markdown](https://mailrith.com/use-cases/nonprofits.md): Email marketing for nonprofits with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Agent guide markdown](https://mailrith.com/developers/agents.md): Recommended discovery flow for AI agents and automation runtimes.
- [SDK guide markdown](https://mailrith.com/developers/sdks.md): Official TypeScript and Python SDK guidance.
- [MCP guide markdown](https://mailrith.com/developers/mcp.md): Remote MCP endpoint and runtime examples.
- [API reference markdown](https://mailrith.com/developers/api-reference.md): Human-readable reference overview; use OpenAPI for exact schemas.

## API and Agent Contracts
- [API catalog](https://mailrith.com/.well-known/api-catalog): Cross-linked machine-readable index for API, MCP, Agent Skills, documentation, and status.
- [Agent discovery status](https://mailrith.com/.well-known/agent-status.json): Monitored API and MCP entry points for the current contract.
- [API metadata](https://api.mailrith.com/v1): Current API version and discovery URLs.
- [OpenAPI document](https://api.mailrith.com/v1/openapi.json): Exact versioned REST schema for request and response validation.
- [Authenticated capabilities](https://api.mailrith.com/v1/capabilities): Workspace-specific API capabilities available to the current key.
- [OAuth authorization server metadata](https://api.mailrith.com/.well-known/oauth-authorization-server): Delegated auth bootstrap for approved OAuth clients.
- [Remote MCP endpoint](https://api.mailrith.com/mcp): Preferred high-level tool interface for supported agent runtimes.
- [MCP server card](https://mailrith.com/.well-known/mcp/server-card.json): Transport, authorization, and contract metadata for MCP clients.
- [Agent Skills index](https://mailrith.com/.well-known/agent-skills/index.json): Current installable discovery guidance and integrity digest.

## User Help Categories
- [Getting Started](https://mailrith.com/docs/category/getting-started.md): Create an account, learn how workspaces are organized, manage billing, and update the account settings that Mailrith workflows use.
- [Subscriber Management](https://mailrith.com/docs/category/audience.md): Manage subscribers, CSV imports and exports, custom fields, tags, double opt-in, and dynamic segments.
- [Forms & Landing Pages](https://mailrith.com/docs/category/capture.md): Build subscriber capture flows with forms, display formats, hosted landing pages, and public confirmation or unsubscribe pages.
- [Privacy And Compliance](https://mailrith.com/docs/category/privacy-compliance.md): Review GDPR and CCPA help, set up consent workflows, and understand Subscriber privacy requests.
- [Campaigns & Delivery](https://mailrith.com/docs/category/campaigns.md): Connect your email delivery service, build reusable templates, and send one-time broadcasts or time-based sequences to selected subscribers.
- [Automation](https://mailrith.com/docs/category/automation.md): Build time-based email sequences, magic links, and multi-step visual automations that respond to subscriber behavior.
- [AI Writing](https://mailrith.com/docs/category/ai.md): Connect AI providers, choose workspace defaults, draft campaigns and sequences, and review generated automation ideas before you use them.
- [Team Management](https://mailrith.com/docs/category/administration.md): Invite team members and assign workspace-specific permissions to each collaborator.

## Developer Guide Categories
- [Getting Started](https://mailrith.com/developers/category/getting-started.md): Create workspace keys, send your first authenticated request, and test the public API in your local environment.
- [API Concepts](https://mailrith.com/developers/category/api-concepts.md): Learn how pagination, errors, idempotency, and versioning work before you connect Mailrith to a sync flow.
- [AI Agent Platform](https://mailrith.com/developers/category/agent-platform.md): Connect agent clients, follow safe task recipes, understand permissions and approvals, and check supported client configurations.
- [API Resources](https://mailrith.com/developers/category/resources.md): Work with subscribers, tags, custom fields, forms, landing pages, segments, and asynchronous import or export jobs.
- [API Reference](https://mailrith.com/developers/category/reference.md): Browse the generated endpoint reference and download the machine-readable OpenAPI contract.

## Email Sending Guide Categories
- [Start Here](https://mailrith.com/guides/category/start-here.md): Learn what happens after you send an email, then choose the right send type before you write the message. Includes 4 guides.
- [Setup and Permission](https://mailrith.com/guides/category/setup-and-permission.md): Prepare the sender, connect an email delivery service, and confirm that the people you email expect your messages. Includes 5 guides.
- [Authentication and Deliverability](https://mailrith.com/guides/category/authentication-and-deliverability.md): Learn how SPF, DKIM, DMARC, alignment, DNS, TLS, sender reputation, and related concepts affect inbox placement. Includes 23 guides.
- [Subscribers](https://mailrith.com/guides/category/audience.md): Choose the right subscribers, use tags and segments carefully, and exclude people who should not receive the email. Includes 2 guides.
- [Message](https://mailrith.com/guides/category/message.md): Write a clear subject, useful body, strong call-to-action, and mobile-friendly email design. Includes 4 guides.
- [Send and Schedule](https://mailrith.com/guides/category/send-and-schedule.md): Test the email, choose delivery settings, decide whether to send now or later, and confirm the final subscriber list. Includes 3 guides.
- [Learn and Fix](https://mailrith.com/guides/category/learn-and-fix.md): Review send results, handle bounces and complaints, fix common delivery issues, and improve the next email. Includes 5 guides.

## Email Sending Guides
- [What Sending an Email Means](https://mailrith.com/guides/what-sending-means.md): Mailrith prepares the campaign, your email delivery service sends the email, and inbox providers decide where the message lands.
- [Email Types and Sender Separation](https://mailrith.com/guides/email-types-and-sender-separation.md): Marketing, transactional, operational, and personal email should not always use the same sender setup.
- [Choose the Right Sending Method](https://mailrith.com/guides/choose-the-right-send.md): Use broadcasts for one-time messages, sequences for planned follow-ups, and automations for behavior-based journeys.
- [Plan Before You Write](https://mailrith.com/guides/plan-before-writing.md): A short plan keeps the email focused and prevents last-minute mistakes with subscribers, the offer, and timing.
- [Prepare the Sender Identity](https://mailrith.com/guides/prepare-sender-identity.md): Choose a sender name, sender email, reply-to address, and verified domain that match the trust you want subscribers to have in your email.
- [Keep Permission and Compliance Simple](https://mailrith.com/guides/permission-and-compliance.md): Send to people who expect your email, identify yourself clearly, and make unsubscribing easy.
- [Protect List Quality](https://mailrith.com/guides/protect-list-quality.md): A smaller list of people who want your emails is better than a large list of people who ignore or reject your emails.
- [Email Delivery Services](https://mailrith.com/guides/smtp-and-delivery-providers.md): An email delivery service sends your email, while Mailrith manages subscribers, campaigns, and follow-up.
- [Connect and Test an Email Delivery Connection](https://mailrith.com/guides/connect-and-test-provider.md): Create a Mailrith delivery connection, save the email delivery service credentials, assign the connection to the correct workspace, and send a test email.
- [Sender Domains and Email Authentication](https://mailrith.com/guides/sender-domains-and-authentication.md): 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.
- [From, Reply-To, and Return-Path](https://mailrith.com/guides/from-reply-to-and-return-path.md): An email can include several sender-related addresses. Each address has a separate role for delivery, authentication, or replies.
- [DNS, PTR, and Reverse DNS](https://mailrith.com/guides/dns-and-reverse-dns.md): DNS records identify your domain. Reverse DNS helps inbox providers check that a sending IP address has a valid hostname.
- [Email Headers and Message Format](https://mailrith.com/guides/email-headers-and-message-format.md): Message headers, MIME structure, and basic formatting rules help inboxes read, display, and trust an email.
- [SPF](https://mailrith.com/guides/spf.md): SPF is a DNS record that lists the servers and services that may send email for your domain.
- [DKIM](https://mailrith.com/guides/dkim.md): DKIM adds a signature to each email so inboxes can confirm that an approved domain accepted responsibility for the message.
- [DMARC](https://mailrith.com/guides/dmarc.md): DMARC tells inboxes how to handle a message that uses your domain but does not pass aligned SPF or DKIM checks.
- [DMARC Alignment](https://mailrith.com/guides/dmarc-alignment.md): DMARC alignment checks whether SPF or DKIM authentication uses the same domain family as the domain subscribers see in the From address.
- [TLS and Secure Sending](https://mailrith.com/guides/tls.md): TLS encrypts email while it moves between mail systems. Bulk senders are now expected to use TLS.
- [MTA-STS and TLS Reporting](https://mailrith.com/guides/mta-sts-and-tls-reporting.md): MTA-STS and TLS reporting are advanced controls for domains that need stronger protection for inbound email transport.
- [ARC and Forwarded Email](https://mailrith.com/guides/arc-and-forwarding.md): ARC helps forwarding services preserve email authentication results when forwarding breaks SPF or changes a message.
- [Sender Reputation and Spam Rate](https://mailrith.com/guides/sender-reputation-and-spam-rate.md): Sender reputation is the trust inbox providers build from your authentication, sending history, volume, complaints, and subscriber behavior.
- [Dedicated and Shared Sending IPs](https://mailrith.com/guides/dedicated-and-shared-ips.md): Shared IPs let many senders use the same sending infrastructure. Dedicated IPs place more reputation responsibility on one sender.
- [Sending Volume and Warmup](https://mailrith.com/guides/start-small.md): New senders should build trust gradually instead of sending a large campaign right away.
- [Blocklists and Link Reputation](https://mailrith.com/guides/blocklists-and-link-reputation.md): Inbox providers may distrust a sender because of the sending IP, domain, email delivery service account, or links in the email.
- [Tracking Domains, Links, and UTMs](https://mailrith.com/guides/tracking-domains-links-and-utms.md): Open tracking, click tracking, tracking domains, and UTM fields affect reporting. They can also affect whether subscribers trust your email.
- [Inbox Placement, Promotions, and Spam Folders](https://mailrith.com/guides/inbox-placement-promotions-and-spam-folders.md): Delivery means the receiving system accepted the message. Placement means where the inbox shows the message.
- [One-Click Unsubscribe and Opt-Outs](https://mailrith.com/guides/one-click-unsubscribe.md): Marketing emails should make unsubscribing easy. Bulk sender rules also expect fast, simple unsubscribe handling.
- [Bounces](https://mailrith.com/guides/bounces.md): A bounce means an email could not be delivered. Repeatedly sending to bad addresses can hurt future delivery.
- [Spam Complaints](https://mailrith.com/guides/spam-complaints.md): A complaint means a subscriber marked your email as spam. Inbox providers treat complaints as one of the strongest negative signals.
- [Complaint Feedback Loops and ARF](https://mailrith.com/guides/complaint-feedback-loops-and-arf.md): Feedback loops tell senders when subscribers mark email as spam. These reports usually come from an email delivery service or mailbox provider.
- [Suppression Lists and Subscriber Status](https://mailrith.com/guides/suppression-lists.md): Suppression protects people who should not receive normal marketing email, including unsubscribed, bounced, or complained subscribers.
- [BIMI](https://mailrith.com/guides/bimi.md): BIMI can show a brand logo in some inboxes, but logo display depends on strong authentication and inbox support.
- [Build the Subscriber List](https://mailrith.com/guides/build-the-audience.md): Subscribers are people, tags describe subscribers, custom fields store subscriber details, and segments choose who matches the rules today.
- [Use Segments and Exclusions](https://mailrith.com/guides/use-segments-and-exclusions.md): Include the people who should receive the email, and exclude the people who should not receive it.
- [Write the Subject and Preview Text](https://mailrith.com/guides/subject-and-preview.md): The subject gets attention. The preview text gives subscribers another reason to open the email.
- [Write the Email Body](https://mailrith.com/guides/write-the-body.md): A good email has one main point, enough context, and one clear next step.
- [Design for Phones First](https://mailrith.com/guides/design-for-phones.md): Most subscribers scan emails quickly, so the email must be easy to read on a small screen.
- [Use Personalization Carefully](https://mailrith.com/guides/personalization.md): Personalization works well when subscriber data is reliable. It feels awkward when subscriber data is missing or wrong.
- [Choose Delivery Settings](https://mailrith.com/guides/delivery-settings.md): The delivery connection, reply-to address, tracking, UTM fields, and schedule should match the campaign purpose.
- [Test Like a Subscriber](https://mailrith.com/guides/test-like-a-subscriber.md): Test an email like a Subscriber by opening, reading, and clicking it on desktop and mobile before you send.
- [Send Now or Schedule](https://mailrith.com/guides/send-now-or-schedule.md): Send a campaign immediately only after the email, subscriber list, send time, and approvals are final.
- [Read the Results](https://mailrith.com/guides/read-results.md): After a campaign sends, review delivery, opens, clicks, unsubscribes, bounces, and complaints together.
- [Handle Bounces, Complaints, and Unsubscribes](https://mailrith.com/guides/handle-bounces-and-complaints.md): Delivery events help protect future sends by keeping risky addresses out of normal campaigns.
- [SMTP Errors, Deferrals, and Throttling](https://mailrith.com/guides/smtp-errors-deferrals-and-throttling.md): SMTP errors and email delivery service responses show whether a delivery problem is temporary, permanent, or caused by rate limits.
- [Troubleshooting Common Sending Problems](https://mailrith.com/guides/troubleshooting.md): You can narrow down most sending issues by checking setup, subscribers, content, email delivery service, and subscriber status.
- [Improve the Next Email](https://mailrith.com/guides/improve-next-email.md): Use each email send to learn one useful lesson and make the next campaign clearer.

## Free Email Tool Categories
- [List Quality](https://mailrith.com/free-tools/index.html.md): Check addresses and subscriber lists before they cause bounces, complaints, or wasted sends. Includes 2 tools.
- [Email Authentication](https://mailrith.com/free-tools/index.html.md): Check the public DNS records that help inboxes verify your sending domain. Includes 12 tools.
- [Reputation](https://mailrith.com/free-tools/index.html.md): Check sender-domain and mail-server signals that can affect whether inboxes trust your email. Includes 4 tools.
- [Email Content](https://mailrith.com/free-tools/index.html.md): Check email copy, links, subject lines, and compliance signals before you send a campaign. Includes 6 tools.

## Free Email Tools
- [Email Checker](https://mailrith.com/free-tools/email-checker.md): Free email checker for syntax, MX records, disposable domains, role addresses, typo suggestions, and plain-English fixes before you send.
- [Bulk Email List Checker](https://mailrith.com/free-tools/bulk-email-list-checker.md): Free bulk email list checker for CSV and pasted lists. Find invalid, risky, duplicate, disposable, role-based, and typo-prone emails with exportable reports.
- [SPF Checker](https://mailrith.com/free-tools/spf-checker.md): Free SPF checker for DNS TXT records, duplicate SPF records, include and redirect lookup counts, all mechanisms, and clear SPF fix guidance.
- [DKIM Checker](https://mailrith.com/free-tools/dkim-checker.md): Free DKIM checker for selector records, TXT and CNAME lookups, missing keys, revoked keys, test mode, and DKIM fix guidance.
- [DMARC Checker](https://mailrith.com/free-tools/dmarc-checker.md): Free DMARC checker for policy, rua reports, alignment, pct rollout, duplicate records, and exact DMARC fix guidance.
- [Email Domain Health Checker](https://mailrith.com/free-tools/email-domain-health-checker.md): Free email domain health checker for MX, SPF, DKIM discovery, DMARC, mail-server IPs, and sender-domain readiness with exact fix guidance.
- [Email Blacklist Checker](https://mailrith.com/free-tools/email-blacklist-checker.md): Free email blacklist checker for mail-server IPs, DNSBL lookups, listing warnings, and plain-English blacklist fix guidance.
- [Email Spam Checker](https://mailrith.com/free-tools/email-spam-checker.md): Free email spam checker for subject lines, preview text, body copy, links, promotional language, unsubscribe signals, and actionable content fixes.
- [Email Deliverability Tester](https://mailrith.com/free-tools/email-deliverability-tester.md): Test email delivery with a real message and check SPF, DKIM, DMARC, alignment, sending IP, blocklists, unsubscribe headers, links, and content.
- [MX Record Checker](https://mailrith.com/free-tools/mx-record-checker.md): Free MX record checker for mail server lookup, missing MX records, fallback address records, mail host review, and simple fix guidance.
- [Email Header Analyzer](https://mailrith.com/free-tools/email-header-analyzer.md): Free email header analyzer for SPF, DKIM, DMARC, Return-Path, DKIM d=, Authentication-Results, Received headers, and alignment review.
- [List-Unsubscribe Header Checker](https://mailrith.com/free-tools/list-unsubscribe-header-checker.md): Free List-Unsubscribe header checker for List-Unsubscribe, List-Unsubscribe-Post, HTTPS one-click URLs, mailto fallback, DKIM coverage, and fix guidance.
- [BIMI Checker](https://mailrith.com/free-tools/bimi-checker.md): Free BIMI checker for default._bimi TXT records, logo URL, VMC or CMC certificate URL, DMARC policy, and BIMI fix guidance.
- [MTA-STS Checker](https://mailrith.com/free-tools/mta-sts-checker.md): Free MTA-STS checker for _mta-sts TXT records, MX records, policy URL guidance, TLS reporting pairing, and plain-English setup notes.
- [TLS-RPT Checker and Generator](https://mailrith.com/free-tools/tls-rpt-checker.md): Free TLS-RPT checker and generator for _smtp._tls TXT records, rua destinations, missing records, and SMTP TLS reporting setup guidance.
- [SMTP TLS Checker](https://mailrith.com/free-tools/smtp-tls-checker.md): Free SMTP TLS checker for MX records, MTA-STS, TLS-RPT, STARTTLS check guidance, and secure mail transport readiness notes.
- [SPF Record Generator](https://mailrith.com/free-tools/spf-record-generator.md): Free SPF record generator for common email providers, include mechanisms, IP addresses, lookup-limit warnings, and simple SPF publishing guidance.
- [DMARC Record Generator](https://mailrith.com/free-tools/dmarc-record-generator.md): Free DMARC record generator for p=none, quarantine, reject, rua reports, pct rollout, alignment defaults, and safe DMARC publishing guidance.
- [Email Subject Line Tester](https://mailrith.com/free-tools/email-subject-line-tester.md): Free email subject line tester for length, mobile clipping, all-caps risk, punctuation, spammy phrases, and plain-English rewrite tips.
- [Email Preview Text Checker](https://mailrith.com/free-tools/email-preview-text-checker.md): Free email preview text checker for length, subject repetition, mobile snippet quality, missing preview text, and practical rewrite guidance.
- [HTML Email Size Checker](https://mailrith.com/free-tools/html-email-size-checker.md): Free HTML email size checker for Gmail clipping risk, byte size, image count, script and form warnings, and email HTML cleanup guidance.
- [Email Links Checker](https://mailrith.com/free-tools/email-links-checker.md): Check email links in your browser for HTTP links, public URL shorteners, visible URL mismatches, link counts, destination domains, and cleanup steps.
- [Reverse DNS PTR Checker](https://mailrith.com/free-tools/reverse-dns-ptr-checker.md): Free reverse DNS PTR checker for IPv4 addresses, mail-server IPs, PTR hostnames, forward-confirmed reverse DNS, and setup guidance.
- [IP Reputation Checker](https://mailrith.com/free-tools/ip-reputation-checker.md): Free IP reputation checker for sending IPs, mail-server IP discovery, public DNSBL checks, PTR review, and email reputation fix guidance.

## Feature Pages
- [Unlimited Subscribers](https://mailrith.com/features/unlimited-subscribers.md): Mailrith Unlimited Subscribers lets you grow your list without per-subscriber Mailrith pricing. Keep tags, fields, segments, forms, and emails in one place.
- [Workspaces](https://mailrith.com/features/workspaces.md): Mailrith Workspaces keep brands, clients, or projects separate with their own subscribers, emails, forms, automations, delivery connections, and team access.
- [Email Delivery Connections](https://mailrith.com/features/email-delivery-connections.md): Mailrith Email Delivery Connections let you use Amazon SES, Postmark, SendGrid, Mailgun, Resend, Brevo, or Custom SMTP while Mailrith manages subscribers and emails.
- [AI Writing](https://mailrith.com/features/ai-writing.md): Mailrith AI Writing helps draft broadcasts, sequence emails, sequence plans, and automation ideas. Review each draft before anything goes live.
- [AI Agents](https://mailrith.com/features/ai-agents.md): Explore Mailrith's AI Agent workflows with OAuth, MCP, SDKs, scoped tools, and dedicated test-workspace guidance.
- [Landing Pages](https://mailrith.com/features/landing-pages.md): Mailrith Landing Pages let you build hosted signup pages with forms, page sections, success pages, and reporting.
- [Forms](https://mailrith.com/features/forms.md): Mailrith Forms let you build signup forms, collect subscriber details, assign tags, and embed the form on your website.
- [Magic Links](https://mailrith.com/features/magic-links.md): Mailrith Magic Links turn a subscriber click into actions such as tagging, sequence enrollment, and simple preference updates.
- [Automations](https://mailrith.com/features/automations.md): Mailrith Automations help you build subscriber follow-up with triggers, waits, rules, emails, tags, and sequences.
- [Sequences](https://mailrith.com/features/sequences.md): Mailrith Sequences send planned emails to subscribers over time for welcome emails, onboarding, and educational follow-up.
- [Broadcasts](https://mailrith.com/features/broadcasts.md): Mailrith Broadcasts help you write, select subscribers, test, schedule, send, and review one-time emails.
- [Tags](https://mailrith.com/features/tags.md): Mailrith Tags help organize subscribers by source, interest, stage, behavior, and email sending rules.
- [Custom Fields](https://mailrith.com/features/custom-fields.md): Mailrith Custom Fields store subscriber details for personalization, segments, forms, imports, and automation rules.
- [Segments](https://mailrith.com/features/segments.md): Mailrith Segments creates reusable subscriber groups from tags, custom fields, status, forms, sequences, and activity rules.
- [Team Management](https://mailrith.com/features/team-management.md): Mailrith Team Management lets you invite teammates, assign workspace access, and manage permissions without sharing passwords.

## Use Cases
- [Email Marketing For Coaches](https://mailrith.com/use-cases/coaches.md): Email marketing for coaches with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Course Creators](https://mailrith.com/use-cases/course-creators.md): Email marketing for course creators with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Bloggers](https://mailrith.com/use-cases/bloggers.md): Email marketing for bloggers with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Newsletter Creators](https://mailrith.com/use-cases/newsletter-creators.md): Email marketing for newsletter creators with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Digital Product Creators](https://mailrith.com/use-cases/digital-product-creators.md): Email marketing for digital product creators with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For WordPress Websites](https://mailrith.com/use-cases/wordpress-websites.md): Email marketing for WordPress websites with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Content Creators](https://mailrith.com/use-cases/content-creators.md): Email marketing for content creators with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Authors](https://mailrith.com/use-cases/authors.md): Email marketing for authors with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Podcasters](https://mailrith.com/use-cases/podcasters.md): Email marketing for podcasters with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For YouTubers](https://mailrith.com/use-cases/youtubers.md): Email marketing for YouTubers with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Small Businesses](https://mailrith.com/use-cases/small-businesses.md): Email marketing for small businesses with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Marketing Consultants](https://mailrith.com/use-cases/marketing-consultants.md): Email marketing for marketing consultants with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Indie Developers](https://mailrith.com/use-cases/indie-developers.md): Email marketing for indie developers with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Real Estate Agents](https://mailrith.com/use-cases/real-estate-agents.md): Email marketing for real estate agents with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Event Organizers](https://mailrith.com/use-cases/event-organizers.md): Email marketing for event organizers with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Gyms](https://mailrith.com/use-cases/gyms.md): Email marketing for gyms with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Law Firms](https://mailrith.com/use-cases/law-firms.md): Email marketing for law firms with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Startups](https://mailrith.com/use-cases/startups.md): Email marketing for startups with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Web Design Agencies](https://mailrith.com/use-cases/web-design-agencies.md): Email marketing for web design agencies with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For SEO Agencies](https://mailrith.com/use-cases/seo-agencies.md): Email marketing for SEO agencies with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Digital Marketing Agencies](https://mailrith.com/use-cases/digital-marketing-agencies.md): Email marketing for digital marketing agencies with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For SaaS Companies](https://mailrith.com/use-cases/saas.md): Email marketing for SaaS with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.
- [Email Marketing For Nonprofit Organizations](https://mailrith.com/use-cases/nonprofits.md): Email marketing for nonprofits with Mailrith: collect subscribers, use forms and automations, and keep your Mailrith price fixed as your list grows.

## Email Sending Setup Guides
- [Amazon SES Email Marketing](https://mailrith.com/features/amazon-ses-email-marketing.md): Use Mailrith with Amazon SES for email marketing campaigns, newsletters, forms, automations, and reports while Amazon SES handles delivery.
- [Custom SMTP Email Marketing](https://mailrith.com/features/custom-smtp-email-marketing.md): Use Custom SMTP with Mailrith to connect an email delivery service for newsletters, campaigns, sequences, automations, and reports.
- [Postmark Email Marketing](https://mailrith.com/features/postmark-email-marketing.md): Postmark Email Marketing with Mailrith: run campaigns, newsletters, forms, automations, and reports while Postmark handles delivery.
- [SendGrid Email Marketing](https://mailrith.com/features/sendgrid-email-marketing.md): SendGrid Email Marketing with Mailrith: run campaigns, newsletters, forms, automations, and reports while SendGrid handles delivery.
- [Mailgun Email Marketing](https://mailrith.com/features/mailgun-email-marketing.md): Mailgun Email Marketing with Mailrith: run campaigns, newsletters, forms, automations, and reports while Mailgun handles delivery.
- [Resend Email Marketing](https://mailrith.com/features/resend-email-marketing.md): Resend Email Marketing with Mailrith: run campaigns, newsletters, forms, automations, and reports while Resend handles delivery.
- [Brevo Email Marketing](https://mailrith.com/features/brevo-email-marketing.md): Brevo Email Marketing with Mailrith: run campaigns, newsletters, forms, automations, and reports while Brevo handles delivery.

## Public API Resources
- [Workspace](https://api.mailrith.com/v1/openapi.json): Read the current authenticated workspace profile, mailing context, and stable workspace identifier. Operations: GET /v1/workspace.
- [Sender Identities](https://api.mailrith.com/v1/openapi.json): Discover enabled sender names, addresses, and provider types that can be selected for Broadcasts and Sequences. Provider credentials are never returned. Operations: GET /v1/sender-identities, GET /v1/sender-identities/{sender_identity_id}.
- [Email Delivery Connections](https://api.mailrith.com/v1/openapi.json): Set up and manage email delivery connections for the authenticated workspace. Provider credentials are entered only in Mailrith's secure browser flow and are never accepted or returned by the agent API. Operations: GET /v1/email-delivery-connections, POST /v1/email-delivery-connection-setup-sessions, GET /v1/email-delivery-connection-setup-sessions/{setup_session_id}, POST /v1/email-delivery-connection-setup-sessions/{setup_session_id}/renew, GET /v1/email-delivery-connections/{connection_id}, PATCH /v1/email-delivery-connections/{connection_id}, PUT /v1/email-delivery-connections/{connection_id}/status, POST /v1/email-delivery-connections/{connection_id}/verify, POST /v1/email-delivery-connections/{connection_id}/test, DELETE /v1/email-delivery-connections/{connection_id}.
- [Analytics](https://api.mailrith.com/v1/openapi.json): Run bounded aggregate reports from compact daily rollups, with explicit metric definitions and previous-period comparisons. Operations: POST /v1/analytics/reports, GET /v1/analytics/reports/{report_id}.
- [Diagnostics](https://api.mailrith.com/v1/openapi.json): Inspect bounded, privacy-conscious execution, delivery, suppression, consent, and engagement diagnostics. Operations: GET /v1/diagnostics/automations/{automation_id}/runs, GET /v1/diagnostics/automations/{automation_id}/runs/{run_id}, GET /v1/diagnostics/sequences/{sequence_id}, GET /v1/diagnostics/broadcasts/{broadcast_id}, GET /v1/diagnostics/subscribers/{subscriber_id}.
- [Subscribers](https://api.mailrith.com/v1/openapi.json): List subscribers in the authenticated workspace and create or upsert subscriber records by email. Operations: GET /v1/subscribers, GET /v1/subscribers/{subscriber_id}, POST /v1/subscribers, PATCH /v1/subscribers/{subscriber_id}, DELETE /v1/subscribers/{subscriber_id}, PUT /v1/subscribers/{subscriber_id}/status, PUT /v1/subscribers/{subscriber_id}/tags/{tag_id}, DELETE /v1/subscribers/{subscriber_id}/tags/{tag_id}, PUT /v1/subscribers/{subscriber_id}/sequences/{sequence_id}, DELETE /v1/subscribers/{subscriber_id}/sequences/{sequence_id}.
- [Tags](https://api.mailrith.com/v1/openapi.json): Read the workspace tag catalog and create tags for targeting, imports, and automation entry conditions. Operations: GET /v1/tags, POST /v1/tags, GET /v1/tags/{tag_id}, PUT /v1/tags/{tag_id}, DELETE /v1/tags/{tag_id}.
- [Custom Fields](https://api.mailrith.com/v1/openapi.json): Read and manage custom-field definitions before writing subscriber custom-field values. Operations: GET /v1/custom-fields, POST /v1/custom-fields, GET /v1/custom-fields/{custom_field_id}, PUT /v1/custom-fields/{custom_field_id}, DELETE /v1/custom-fields/{custom_field_id}.
- [Email Templates](https://api.mailrith.com/v1/openapi.json): Create and manage reusable email templates that agents can apply across broadcasts, sequences, and automations. Operations: GET /v1/email-templates, POST /v1/email-templates, GET /v1/email-templates/{template_id}, POST /v1/email-templates/{template_id}/preview, PUT /v1/email-templates/{template_id}, DELETE /v1/email-templates/{template_id}.
- [Starting Points](https://api.mailrith.com/v1/openapi.json): Discover the same email, Form, and Landing Page starting points shown in the Mailrith UI. Lists return metadata only; item reads return full content on demand. Operations: GET /v1/starting-points/email-templates, GET /v1/starting-points/email-templates/{starting_point_id}, GET /v1/starting-points/forms, GET /v1/starting-points/forms/{starting_point_id}, GET /v1/starting-points/landing-pages, GET /v1/starting-points/landing-pages/{starting_point_id}.
- [Forms](https://api.mailrith.com/v1/openapi.json): Create and manage Mailrith-managed forms, then inspect definitions, styling payloads, and public URLs. Operations: GET /v1/forms, POST /v1/forms, GET /v1/forms/{form_id}, GET /v1/forms/{form_id}/submissions, GET /v1/forms/{form_id}/submissions/{submission_id}, POST /v1/forms/{form_id}/double-opt-in-preview, PUT /v1/forms/{form_id}, DELETE /v1/forms/{form_id}.
- [Landing Pages](https://api.mailrith.com/v1/openapi.json): Create and manage Mailrith-hosted landing pages, custom slugs, page definitions, settings, and public URLs. Operations: GET /v1/landing-pages, POST /v1/landing-pages, GET /v1/landing-pages/{landing_page_id}, GET /v1/landing-pages/{landing_page_id}/submissions, GET /v1/landing-pages/{landing_page_id}/submissions/{submission_id}, POST /v1/landing-pages/{landing_page_id}/double-opt-in-preview, PUT /v1/landing-pages/{landing_page_id}, DELETE /v1/landing-pages/{landing_page_id}.
- [Sequences](https://api.mailrith.com/v1/openapi.json): Create and manage onboarding or lifecycle sequences, including status, delivery settings, and definition payloads. Operations: GET /v1/sequences, POST /v1/sequences, GET /v1/sequences/{sequence_id}, GET /v1/sequences/{sequence_id}/preflight, GET /v1/sequences/{sequence_id}/journey-preview, POST /v1/sequences/{sequence_id}/test, PUT /v1/sequences/{sequence_id}, PUT /v1/sequences/{sequence_id}/status, DELETE /v1/sequences/{sequence_id}.
- [Automations](https://api.mailrith.com/v1/openapi.json): Create and manage automations with explicit lifecycle states and normalized definition payloads. Operations: GET /v1/automations, POST /v1/automations, GET /v1/automations/{automation_id}, GET /v1/automations/{automation_id}/preflight, GET /v1/automations/{automation_id}/journey-preview, POST /v1/automations/{automation_id}/test, PUT /v1/automations/{automation_id}, PUT /v1/automations/{automation_id}/status, DELETE /v1/automations/{automation_id}.
- [Magic Links](https://api.mailrith.com/v1/openapi.json): Create and manage magic links with explicit targets, post-click actions, and a public execution URL. Operations: GET /v1/magic-links, POST /v1/magic-links, GET /v1/magic-links/{magic_link_id}, PUT /v1/magic-links/{magic_link_id}, DELETE /v1/magic-links/{magic_link_id}.
- [Broadcasts](https://api.mailrith.com/v1/openapi.json): Create and manage broadcast drafts, schedule future delivery, send test emails, and launch immediate sends. Operations: GET /v1/broadcasts, POST /v1/broadcasts, GET /v1/broadcasts/{broadcast_id}/progress, GET /v1/broadcasts/{broadcast_id}/delivery-errors, GET /v1/broadcasts/{broadcast_id}, PUT /v1/broadcasts/{broadcast_id}, DELETE /v1/broadcasts/{broadcast_id}, GET /v1/broadcasts/{broadcast_id}/preflight, PUT /v1/broadcasts/{broadcast_id}/schedule, DELETE /v1/broadcasts/{broadcast_id}/schedule, POST /v1/broadcasts/{broadcast_id}/send, POST /v1/broadcasts/{broadcast_id}/cancel, POST /v1/broadcasts/{broadcast_id}/test.
- [Segments](https://api.mailrith.com/v1/openapi.json): Create and manage saved segments, and preview unsaved segment definitions before persisting them. Operations: GET /v1/segments, POST /v1/segments, GET /v1/segments/{segment_id}, PUT /v1/segments/{segment_id}, DELETE /v1/segments/{segment_id}, POST /v1/segments/preview.
- [Webhook Subscriptions](https://api.mailrith.com/v1/openapi.json): Create and manage signed outbound webhook subscriptions so agents can react to Mailrith events without polling. Operations: GET /v1/webhook-subscriptions, POST /v1/webhook-subscriptions, GET /v1/webhook-subscriptions/{webhook_subscription_id}, PUT /v1/webhook-subscriptions/{webhook_subscription_id}, DELETE /v1/webhook-subscriptions/{webhook_subscription_id}, POST /v1/webhook-subscriptions/{webhook_subscription_id}/rotate-secret.
- [Import and Export Jobs](https://api.mailrith.com/v1/openapi.json): Queue asynchronous subscriber import and export jobs and poll them to completion. Operations: POST /v1/jobs/subscriber-import-uploads, GET /v1/jobs/subscriber-import-uploads/{upload_id}, GET /v1/jobs/subscriber-imports, POST /v1/jobs/subscriber-imports, GET /v1/jobs/subscriber-imports/{job_id}, GET /v1/jobs/subscriber-exports, POST /v1/jobs/subscriber-exports, GET /v1/jobs/subscriber-exports/{job_id}.

## Developer Guides
- [Quickstart](https://mailrith.com/developers/quickstart.md): Start with one workspace API key, one authenticated request, and the generated response envelope. This page covers the minimum steps needed to create a working subscriber sync.
- [Authentication](https://mailrith.com/developers/authentication.md): Every protected `v1` request is authorized through a workspace-scoped API key. This page covers the required header shape, workspace scoping behavior, and authentication failure handling.
- [Testing the API](https://mailrith.com/developers/testing-the-api.md): You can test Mailrith's public API manually with local curl requests or automatically with the integration suite. This page shows the repo-native commands for both testing paths.
- [Agents](https://mailrith.com/developers/agents.md): Mailrith exposes a compact discovery stack for AI agents: llms files on the marketing site, version metadata on the API root, the versioned OpenAPI contract, authenticated capability discovery, and official SDK and MCP entry points after a workspace key is available.
- [AI Agent Quickstarts](https://mailrith.com/developers/agent-quickstarts.md): Follow task-based paths for a five-minute read, complete Broadcast and Sequence workflows, and dedicated test-workspace testing without giving an agent broad workspace control.
- [AI Agent Architecture And Security](https://mailrith.com/developers/agent-security.md): Mailrith uses one public resource model, least-privilege credentials, typed operations, existing delivery safeguards, request IDs, and current-resource verification across every supported agent client.
- [AI Agent Client Compatibility](https://mailrith.com/developers/agent-compatibility.md): Use the current compatibility matrix and read-only starter configurations, then record live conformance against an exact client build or review date before making a support claim.
- [AI Agent Examples](https://mailrith.com/developers/agent-examples.md): Each example demonstrates one safe Mailrith workflow, lists its required permissions, and keeps reads, retries, writes, and stored data bounded.
- [AI Agent Analytics And Compliance](https://mailrith.com/developers/agent-analytics-and-compliance.md): Use compact outcome reports and privacy-conscious diagnostics, then change real Mailrith resources through their task permissions and normal safeguards.
- [AI Agent Supported Actions And Support](https://mailrith.com/developers/agent-supported-actions.md): Use the current supported-actions matrix, understand operation terms, account for freshness and compliance boundaries, and troubleshoot without sharing secrets or Subscriber content.
- [SDKs](https://mailrith.com/developers/sdks.md): Mailrith ships official TypeScript and Python SDKs generated from the same public contract that powers the OpenAPI document and capability map.
- [MCP Server](https://mailrith.com/developers/mcp.md): Mailrith's official MCP server is the highest-level interface for agent runtimes. This page covers the remote endpoint and includes copy-paste examples for OpenAI, Claude, n8n, and Pipedream.
- [Zapier](https://mailrith.com/developers/zapier.md): Mailrith's Zapier package maps the public API into OAuth authentication, instant REST Hook triggers, Kit-style subscriber actions, raw authenticated API requests, and subscriber search. This page explains the code structure, local validation, and publishing process.
- [Pagination](https://mailrith.com/developers/pagination.md): Mailrith uses cursor pagination across list endpoints. This guide explains how to request the first page, continue with `next_cursor`, resume interrupted syncs, and reuse the same pagination pattern across subscribers, tags, custom fields, forms, and segments.
- [Errors](https://mailrith.com/developers/errors.md): Non-2xx responses include stable error codes and plain-language messages. This guide explains how to log errors, avoid matching on message text, map status codes to user or system actions, and retry only when the same request may succeed later.
- [Idempotency](https://mailrith.com/developers/idempotency.md): Import and export job creation endpoints accept idempotency keys so network retries do not queue duplicate work. This guide explains when to use a key, how to choose one, and how to store the key with your own job record.
- [Versioning](https://mailrith.com/developers/versioning.md): Mailrith versions the public API in the path. This guide explains the `/v1` contract boundary, which base URLs to call, how to avoid unversioned paths, and how to compare future API versions before you upgrade.
- [Consent And Privacy API Boundaries](https://mailrith.com/developers/consent-and-lawful-basis.md): The public Subscriber API stores profile and list-management data, not separate consent-evidence fields. This guide explains the API boundary, safe Subscriber upserts, imports, webhooks, and when to use Mailrith-hosted GDPR consent workflows.
- [Subscribers API](https://mailrith.com/developers/subscribers.md): The subscribers resource is the main way integrations write Subscriber data in `v1`. This guide explains when to list subscribers, when to upsert subscribers, how Mailrith chooses the workspace, what to include in an upsert body, and when to use async imports instead of many single requests.
- [Tags API](https://mailrith.com/developers/tags.md): The tags API gives integrations a lightweight way to manage subscriber labels. This guide explains when to use tags, when to use custom fields instead, how to list or create tags, and how to name tags so workspace users understand each label.
- [Custom Fields API](https://mailrith.com/developers/custom-fields.md): Custom fields define the typed workspace schema shared by subscribers, forms, and segments. This guide explains how to choose field types, map external data sources, create field definitions, and avoid schema changes that break forms or reports.
- [Forms API](https://mailrith.com/developers/forms.md): The forms API lets integrations manage capture forms outside the app. This guide explains when to list, create, update, or delete forms, how forms depend on fields and tags, and how to update live forms without breaking website signups.
- [Landing Pages API](https://mailrith.com/developers/landing-pages.md): The landing pages API lets integrations manage hosted capture pages outside the app. This guide explains when to list, create, update, or delete landing pages, how page definitions depend on tags and fields, and how to update public pages safely.
- [Email Templates API](https://mailrith.com/developers/email-templates.md): The email templates resource supports migrations, governance, and external template sync. This guide explains when to use templates, how to preserve structured editor content, and how to keep template names and descriptions useful for workspace users.
- [Broadcasts API](https://mailrith.com/developers/broadcasts.md): The Broadcasts resource is the public control plane for one-off messages. This guide explains draft management, test sends, and live-send safety.
- [Sequences API](https://mailrith.com/developers/sequences.md): The sequences resource lets external systems prepare, migrate, or synchronize time-based email series. This guide explains how to plan sequence definitions, when to update or delete sequences, and what to check before migrated journeys reach real subscribers.
- [Automations API](https://mailrith.com/developers/automations.md): The automations resource exposes Mailrith workflow definitions for tools that create or synchronize automations outside the app. This guide explains what automations can affect, how to use the public schema, and what to review before you trust a generated workflow.
- [Magic Links API](https://mailrith.com/developers/magic-links.md): The Magic Links resource lets external tools create and maintain Subscriber action links. This guide explains where to use Magic Links, how to match each action with the correct destination, and how to test links before live Broadcasts or active Sequences.
- [Segments API](https://mailrith.com/developers/segments.md): The segments API supports saved segment definitions, imported subscriber rules, and previews for unsaved logic. This guide explains how segments behave, when to save segments, and why preview is the safest step before using complex subscriber rules.
- [Import and Export Jobs](https://mailrith.com/developers/jobs.md): Imports and exports are asynchronous in `v1`. This guide explains when to queue a job, how import mappings and export filters work at a high level, how to use idempotency, and how to monitor final job status without confusing queued work with completed work.
- [Webhook Subscriptions API](https://mailrith.com/developers/webhook-subscriptions.md): Webhook subscriptions let external systems receive Mailrith events for syncs, dashboards, fulfillment, and audit trails. This guide explains when to use webhooks, how to manage subscriptions, why you must store the signing secret immediately, and how receivers should verify and deduplicate deliveries.

## Optional
- [Human agent guide](https://mailrith.com/developers/agents): Browser-oriented version of the agent discovery guide.
- [Human SDK guide](https://mailrith.com/developers/sdks): Browser-oriented version of the SDK guide.
- [Human MCP guide](https://mailrith.com/developers/mcp): Browser-oriented version of the MCP guide.
- [Human API reference](https://mailrith.com/developers/api-reference): Browser-oriented API reference page.