# Werkmail Docs

> Official documentation for Werkmail, the EU email platform for authenticated sending, DSGVO consent, and inbox placement.

Prefer the Markdown URLs below. HTML is at the same path without `.md`.
Canonical host: https://docs.werkmail.eu/

## Start
- [Werkmail documentation](https://docs.werkmail.eu/index.md): Guides, API reference, and changelog for Werkmail — the EU email platform for authenticated sending, DSGVO consent, and inbox placement.
- [Use these docs with LLMs](https://docs.werkmail.eu/for-llms.md): How language models and agents should fetch, cite, and stay current on Werkmail documentation.

## Guides
- [Getting started](https://docs.werkmail.eu/getting-started.md): Create a Werkmail workspace, authenticate a sending domain, and send your first email through the API or the dashboard.
- [Concepts](https://docs.werkmail.eu/concepts.md): How Werkmail models tenants, projects, routes, message kinds, consent, and isolation.
- [DNS and authentication](https://docs.werkmail.eu/dns-and-authentication.md): SPF, DKIM, DMARC, MAIL FROM, and BIMI records Werkmail expects on your sending domain.
- [Sending mail](https://docs.werkmail.eu/sending.md): Single, batch, and bulk sends, attachments, idempotency, content scoring, and List-Unsubscribe behaviour.
- [Raw source and branding](https://docs.werkmail.eu/raw-source-and-branding.md): What recipients see in View Source — Message-ID, DKIM, Return-Path, and what Werkmail can brand.
- [Inbound mail](https://docs.werkmail.eu/inbound.md): Receive mail on in.your-domain only, list inbound messages, and send through a signed inbound hook.
- [Webhooks](https://docs.werkmail.eu/webhooks.md): Subscribe to signed Werkmail delivery events and verify X-Werkmail-Signature.
- [Compliance](https://docs.werkmail.eu/compliance.md): Double opt-in, Impressum gates, consent ledger, unsubscribe, abuse reports, and DSAR-oriented controls.
- [Deliverability](https://docs.werkmail.eu/deliverability.md): Warm-up, reputation pause, content scoring, tracking pixels, and how Werkmail keeps transactional and marketing streams apart.

## API
- [HTTP API overview](https://docs.werkmail.eu/api.md): Base URL, versioning, authentication choices, and how the Werkmail HTTP API is organised.
- [API authentication](https://docs.werkmail.eu/api/authentication.md): Bearer sessions, team and project tokens, admin token, and how Werkmail scopes access.
- [Send API](https://docs.werkmail.eu/api/send.md): POST /api/practices/{id}/send, batch, bulk, score, and send-test — fields, limits, and responses.
- [Messages API](https://docs.werkmail.eu/api/messages.md): List, search, and inspect outbound messages, events, and the per-message timeline.
- [Webhooks API](https://docs.werkmail.eu/api/webhooks.md): Create Werkmail webhook subscriptions, list deliveries, and verify HMAC signatures.
- [Suppressions API](https://docs.werkmail.eu/api/suppressions.md): Team, project, and route-scoped suppression lists — add, import, export, and delete.
- [Inbound API](https://docs.werkmail.eu/api/inbound.md): Enable receiving on in.domain, list inbound messages, and send via X-Werkmail-Hook-Secret.
- [Lists and campaigns API](https://docs.werkmail.eu/api/lists-and-campaigns.md): Create subscriber lists, import contacts, run double opt-in, and queue broadcast campaigns.
- [Errors and limits](https://docs.werkmail.eu/api/errors.md): Werkmail API error JSON, common codes, rate limits, and idempotency behaviour.
- [API endpoint reference](https://docs.werkmail.eu/api/reference.md): Curated map of Werkmail HTTP endpoints for workspaces, send, DNS, inbound, webhooks, lists, and billing.

## Platform
- [Changelog](https://docs.werkmail.eu/changelog.md): User-facing Werkmail product changes — documentation site, onboarding, DNS, abuse, and API behaviour.

## Optional
- Full Markdown corpus: https://docs.werkmail.eu/llms-full.txt
- OpenAPI: https://werkmail.eu/openapi.yaml
- Product home: https://werkmail.eu/
- How to fetch these docs: https://docs.werkmail.eu/for-llms.md