# Mailvina

> Mailvina is an email sending platform for developers: a REST API and SMTP relay for transactional and marketing email, with domain authentication (DKIM, SPF, DMARC), webhooks, open/click tracking, suppression lists, broadcasts, templates, analytics and IP warm-up.

API base URL: https://api.mailvina.com. Authenticate with `Authorization: Bearer <API key>` (keys start with `mv_`). Every page below is available as Markdown. The full documentation in one file: https://mailvina.com/llms-full.txt

## Getting started

- [Introduction](https://mailvina.com/docs.md): What Mailvina is, how sending works end to end, and where to start.
- [Quickstart](https://mailvina.com/docs/quickstart.md): Send your first email in under five minutes, before verifying a domain.
- [Authentication](https://mailvina.com/docs/authentication.md): Authenticate API requests with a bearer API key, and choose the right key permission.

## Guides

- [Sending email](https://mailvina.com/docs/send-email.md): Send, batch, schedule and cancel emails; attachments, tags, headers, idempotency and test addresses.
- [Domains](https://mailvina.com/docs/domains.md): Add and verify a sending domain with DKIM, SPF and MX records, set up a custom tracking subdomain, and choose TLS.
- [API keys](https://mailvina.com/docs/api-keys.md): Create, scope and rotate API keys.
- [SMTP relay](https://mailvina.com/docs/smtp.md): Send through Mailvina from any app or framework that speaks SMTP.
- [Webhooks](https://mailvina.com/docs/webhooks.md): Receive signed delivery and engagement events, verify signatures and handle retries.
- [Templates](https://mailvina.com/docs/templates.md): Store reusable subjects and HTML with variables, then send by ID or alias.
- [Broadcasts](https://mailvina.com/docs/broadcasts.md): Send one message to every subscribed contact in an audience, now or on a schedule.
- [Audiences & contacts](https://mailvina.com/docs/audiences.md): Organise recipients into audiences for broadcasts, and keep subscription status in sync.
- [Suppression list](https://mailvina.com/docs/suppressions.md): How hard bounces and spam complaints are suppressed automatically, and how to manage the list.
- [Open & click tracking](https://mailvina.com/docs/tracking.md): How the open pixel and link rewriting work, their limits, and custom tracking subdomains.

## Deliverability

- [IP warm-up](https://mailvina.com/docs/ip-warmup.md): How Mailvina warms up new sending IPs safely and automatically.
- [Deliverability](https://mailvina.com/docs/deliverability.md): Authentication, bounces, complaints and reputation: what Mailvina does and what you should do.
- [Analytics & logs](https://mailvina.com/docs/analytics.md): Delivery metrics, per-email event logs, and the metrics API.

## Reference

- [Limits & errors](https://mailvina.com/docs/limits-and-errors.md): Rate limits, sending quotas, the error format and every error code.

## API reference

- [Emails](https://mailvina.com/docs/api-reference/emails.md): Send single and batch emails, and retrieve, list, reschedule or cancel them.
- [Domains](https://mailvina.com/docs/api-reference/domains.md): Add, verify, configure and remove sending domains.
- [API keys](https://mailvina.com/docs/api-reference/api-keys.md): Create, list and delete API keys. Requires a `full` access key.
- [Audiences & contacts](https://mailvina.com/docs/api-reference/audiences.md): Manage audiences and the contacts in them.
- [Broadcasts](https://mailvina.com/docs/api-reference/broadcasts.md): Create, update, send and delete broadcasts.
- [Templates](https://mailvina.com/docs/api-reference/templates.md): Create and manage reusable email templates. Look them up by ID or alias.
- [Webhooks](https://mailvina.com/docs/api-reference/webhooks.md): Create and manage webhook endpoints.
- [Suppressions](https://mailvina.com/docs/api-reference/suppressions.md): List, add and remove suppressed addresses.
- [Metrics](https://mailvina.com/docs/api-reference/metrics.md): Aggregate sending metrics for your team.