Documentation
Everything you need to send email with MailerOwl.
Getting started
- Quickstart — Send your first email with [[.Brand]] in about ten minutes.
- Concepts — Organizations, domains, API keys and test mode explained.
Domains
- Add and verify a domain — Verify a sending domain with DKIM and a custom MAIL FROM.
Sending
- Send an email — POST /v1/emails fields, responses and errors.
- Batch sending — Send up to 500 emails in one request.
- Attachments — Attach files and inline images.
- Scheduling — Send an email later.
- Idempotency — Retry requests safely with idempotency keys.
- Marketing email and unsubscribe — Send opted-in marketing mail with one-click unsubscribe.
- SMTP relay — Send through [[.SMTPHost]] with an API key as the password.
Events
- Event types — Delivery, bounce, complaint, open and click events.
- Webhooks — Signed webhook payloads, retries and the delivery log.
- Verify webhook signatures — Verify MailerOwl webhook signatures in Node, Python, Go and PHP.
Deliverability
- Suppression lists — How suppression works and how to manage it.
- Bounces, complaints and best practices — Thresholds that pause sending, and how to stay healthy.
Account
- Team and roles — Invite teammates and understand roles.
- Error codes and rate limits — API errors, HTTP statuses and rate limit headers.
Reference
- API reference — every /v1 endpoint (OpenAPI 3.1)