# Groundmail

> Transactional email API on owned infrastructure — Pool for production mail, Dedicated for managed servers and IPs.

## Product
- Home: https://groundmail.dev/
- Transactional email API: https://groundmail.dev/transactional-email-api
- Infrastructure: https://groundmail.dev/infrastructure
- Pricing: https://groundmail.dev/pricing
- vs Resend: https://groundmail.dev/compare/resend
- vs Postmark: https://groundmail.dev/compare/postmark
- vs Amazon SES: https://groundmail.dev/compare/amazon-ses
- vs SendGrid: https://groundmail.dev/compare/sendgrid
- Supabase integration: https://groundmail.dev/integrations/supabase
- Changelog: https://groundmail.dev/changelog
- Open source SDKs & tools: https://groundmail.dev/open-source

## Learn
- Learn hub: https://groundmail.dev/learn
- Transactional email: the complete guide for developers: https://groundmail.dev/learn/transactional-email
- Transactional vs marketing email: why you must separate the streams: https://groundmail.dev/learn/transactional-vs-marketing-email
- How to choose a transactional email service: https://groundmail.dev/learn/transactional-email-services
- Transactional email best practices for product teams: https://groundmail.dev/learn/transactional-email-best-practices
- SendGrid alternatives for transactional email (2026): https://groundmail.dev/learn/sendgrid-alternatives
- Postmark alternatives for transactional email (2026): https://groundmail.dev/learn/postmark-alternatives
- Email deliverability: the 2026 playbook for transactional senders: https://groundmail.dev/learn/email-deliverability
- Why your emails go to spam (and how to fix it): https://groundmail.dev/learn/why-emails-go-to-spam
- SPF, DKIM, and DMARC explained (with the alignment rule everyone misses): https://groundmail.dev/learn/spf-dkim-dmarc
- What is BIMI email (and what the Gmail via label means): https://groundmail.dev/learn/bimi-email
- Email bounces, complaints, and suppression: a handling guide: https://groundmail.dev/learn/email-bounces
- Dedicated IP vs shared IP: choosing your sending infrastructure: https://groundmail.dev/learn/dedicated-ip-vs-shared-ip
- IP warmup: how to bring a new sending IP to full volume: https://groundmail.dev/learn/ip-warmup
- Email infrastructure: what it takes to run your own, and when to: https://groundmail.dev/learn/email-infrastructure
- Password reset, magic link, and OTP emails done properly: https://groundmail.dev/learn/authentication-emails

## API
- Base URL: https://api.groundmail.dev
- Auth: Authorization: Bearer gm_…
- App dashboard: https://app.groundmail.dev
- OpenAPI: https://docs.groundmail.dev/openapi.yaml
- Sandbox from (self-test only): noreply@mail.groundmail.dev

## Packages
- npm SDK: groundmail
- Python SDK: groundmail
- Go module: github.com/Groundmail/groundmail-sdks/go
- PHP SDK: groundmail/groundmail
- Ruby gem: groundmail
- Symfony Mailer: groundmail/symfony-mailer
- Laravel package: groundmail/laravel
- CLI: groundmail-cli
- MCP server: groundmail-mcp

## Getting Started
- Introduction: https://docs.groundmail.dev
- Quickstart: https://docs.groundmail.dev/quickstart
- Authentication: https://docs.groundmail.dev/authentication
- Errors: https://docs.groundmail.dev/errors
- Resend migration: https://docs.groundmail.dev/migration
- Postmark migration: https://docs.groundmail.dev/migration/postmark
- SES migration: https://docs.groundmail.dev/migration/ses
- SendGrid migration: https://docs.groundmail.dev/migration/sendgrid

## Guides
- Password reset email best practices: https://docs.groundmail.dev/guides/password-reset-emails
- Auth provider email for password resets: https://docs.groundmail.dev/guides/auth-provider-email
- Supabase Auth email: https://docs.groundmail.dev/guides/supabase
- Better Auth email: https://docs.groundmail.dev/guides/better-auth
- Auth.js / NextAuth email: https://docs.groundmail.dev/guides/authjs
- Clerk email: https://docs.groundmail.dev/guides/clerk
- Payload CMS email: https://docs.groundmail.dev/guides/payload
- n8n community node: https://docs.groundmail.dev/guides/n8n
- React Email: https://docs.groundmail.dev/guides/react-email

## Resources
- Emails: https://docs.groundmail.dev/emails
- Domains: https://docs.groundmail.dev/domains
- Webhooks: https://docs.groundmail.dev/webhooks
- Templates: https://docs.groundmail.dev/templates
- Events: https://docs.groundmail.dev/events
- Automations: https://docs.groundmail.dev/automations
- Integrations: https://docs.groundmail.dev/integrations
- API Keys: https://docs.groundmail.dev/api-keys
- Suppressions: https://docs.groundmail.dev/suppressions
- Inbound: https://docs.groundmail.dev/inbound
- Deliverability: https://docs.groundmail.dev/deliverability
- SMTP: https://docs.groundmail.dev/smtp

## SDKs & Frameworks
- Node.js: https://docs.groundmail.dev/frameworks/node
- Next.js: https://docs.groundmail.dev/frameworks/nextjs
- Python: https://docs.groundmail.dev/sdks/python
- Go: https://docs.groundmail.dev/sdks/go
- PHP: https://docs.groundmail.dev/sdks/php
- Ruby: https://docs.groundmail.dev/sdks/ruby
- Laravel: https://docs.groundmail.dev/frameworks/laravel
- Symfony: https://docs.groundmail.dev/frameworks/symfony

## Agents
- Agent Skills: https://docs.groundmail.dev/ai/agent-skills
- Agent skill notes: https://docs.groundmail.dev/ai/agent-skill
- MCP server: https://docs.groundmail.dev/ai/mcp
- llms-full.txt: https://docs.groundmail.dev/llms-full.txt
- Agent Skills install: https://docs.groundmail.dev/ai/agent-skills
- Agent skill (markdown): https://docs.groundmail.dev/ai/markdown/agent-skill
- Agent Skills index (JSON): https://docs.groundmail.dev/.well-known/agent-skills/index.json

## AI builders
- Overview: https://docs.groundmail.dev/builders
- Lovable: https://docs.groundmail.dev/builders/lovable
- Replit: https://docs.groundmail.dev/builders/replit
- Bolt.new: https://docs.groundmail.dev/builders/bolt
- Base44: https://docs.groundmail.dev/builders/base44
- v0: https://docs.groundmail.dev/builders/v0

## Reference
- API Explorer: https://docs.groundmail.dev/api-explorer
- OpenAPI: https://docs.groundmail.dev/openapi.yaml

## Core endpoints
- POST /emails
- GET /emails
- GET /emails/{id}
- POST /domains
- GET /domains/{id}
- POST /domains/{id} action=apply|verify
- GET /deliverability