# RavenRelay

> Transactional email API. Free: 5,000 accepted recipient sends per workspace per UTC month, unlimited connected domains, no added branding, no RavenRelay daily quota. Production activation and API/provider limits apply. Development delivers only to exact verified domains in the same project.

Every documentation page has a Markdown version. Prefer the links below for agent consumption. Keep API keys and webhook secrets private.

## Documentation (Markdown)

- [Send your first email](https://docs.ravenrelay.joshlab.site/markdown/quickstart.md): Verify a domain, create a scoped key and send transactional email from your application server.
- [Sending domains](https://docs.ravenrelay.joshlab.site/markdown/domains.md): Authenticate your sender with DKIM, custom MAIL FROM and a clear DNS verification workflow.
- [API keys and environments](https://docs.ravenrelay.joshlab.site/markdown/api-keys.md): Keep application authentication scoped to a project and separate from dashboard sessions.
- [The free tier](https://docs.ravenrelay.joshlab.site/markdown/free-tier.md): 5,000 monthly recipient sends per workspace. Unlimited connected domains. Your emails, your brand.
- [Complete integration guide](https://docs.ravenrelay.joshlab.site/markdown/integration-guide.md): From domain verification to safe development sends, production activation and verified delivery webhooks.
- [React Email and templates](https://docs.ravenrelay.joshlab.site/markdown/email-templates.md): Build emails in React or reuse project templates with variables.
- [Find emails and webhook attempts](https://docs.ravenrelay.joshlab.site/markdown/log-filters.md): Filter project logs and inspect delivery retries.
- [Key expiration and rotation](https://docs.ravenrelay.joshlab.site/markdown/key-lifecycle.md): Keep credentials current without resetting usage limits.
- [Send an email](https://docs.ravenrelay.joshlab.site/markdown/send-email.md): POST /v1/emails accepts a message for durable, asynchronous processing.
- [Retrieve emails](https://docs.ravenrelay.joshlab.site/markdown/email-logs.md): Read project-scoped email logs, recipient outcomes and the event timeline.
- [Errors and retries](https://docs.ravenrelay.joshlab.site/markdown/errors.md): Handle structured errors and distinguish a rejected request from uncertain provider acceptance.
- [SDKs for other languages](https://docs.ravenrelay.joshlab.site/markdown/language-sdks.md): Use Python, PHP, Go and Ruby clients for the public email API.
- [Node.js SDK](https://docs.ravenrelay.joshlab.site/markdown/node-sdk.md): Use the published Node.js client for sending and reading email, and verifying webhook signatures.
- [Delivery events](https://docs.ravenrelay.joshlab.site/markdown/delivery-events.md): Track recipient outcomes and keep provider acceptance separate from actual delivery.
- [Automatic suppressions](https://docs.ravenrelay.joshlab.site/markdown/suppressions.md): Protect your sending reputation by blocking addresses that hard-bounce or complain.
- [Signed webhooks](https://docs.ravenrelay.joshlab.site/markdown/webhooks.md): Receive delivery outcomes in your application with authenticated payloads, retries and delivery logs.
- [Sending safely](https://docs.ravenrelay.joshlab.site/markdown/acceptable-use.md): Workspace reputation safeguards and prohibited use.
- [Data processing and retention](https://docs.ravenrelay.joshlab.site/markdown/data-processing.md): How email, AI conversations and support data are processed, retained and deleted.
- [Documentation for agents](https://docs.ravenrelay.joshlab.site/markdown/agent-docs.md): Read the same documentation as Markdown, discover it through llms.txt, and inspect the OpenAPI contract.

## Machine-readable resources

- [OpenAPI 3.1](https://docs.ravenrelay.joshlab.site/openapi.json): Public sending and reading API, signed webhook contract.
- [Complete Markdown corpus](https://docs.ravenrelay.joshlab.site/llms-full.txt): All documentation in one file.