GroundmailDocs

Groundmail + Base44

Base44 apps can send email through built-in platform features. Use Groundmail when you need your own domain, higher control over deliverability, or the same transactional stack as the rest of your product.

When Base44 built-in email is enough

  • Early prototypes and internal tools
  • Low volume without a custom domain requirement
  • Flows where Base44’s default sender is acceptable

When to add Groundmail

  • Branded mail from @yourdomain.com after DNS verify
  • Password reset / auth mail you want on owned transactional infrastructure
  • Webhooks and delivery visibility via Groundmail dashboard
  • Consistent API across non-Base44 services (same POST /emails everywhere)

1. Add your API key

  1. Create gm_… at app.groundmail.dev.
  2. In Base44, add a project secret or environment variable (exact UI varies by Base44 project type):
GROUNDMAIL_API_KEY=gm_your_key_here

Wire server-side code or automation steps to read that variable — never expose it in client-visible config.

2. Paste this prompt in Base44

Add Groundmail for transactional email in this Base44 app (instead of or alongside built-in email).

Docs:
- https://docs.groundmail.dev/ai/agent-skill
- https://docs.groundmail.dev/openapi.yaml
- https://docs.groundmail.dev/builders/base44

Rules:
1. Use GROUNDMAIL_API_KEY from project secrets — server-side only.
2. POST https://api.groundmail.dev/emails with Bearer auth for transactional sends (reset, verify, receipts).
3. Sandbox until domain verify: from "noreply@mail.groundmail.dev", to Groundmail account email only.
4. Explain when built-in Base44 email is still fine vs when Groundmail is required (custom domain, production volume).
5. Use html/text; verify domain in Groundmail before production from addresses.

Link users to https://app.groundmail.dev for domain setup.

3. HTTP send

POST https://api.groundmail.dev/emails
Authorization: Bearer gm_…
Content-Type: application/json

{
  "from": "noreply@yourdomain.com",
  "to": "user@example.com",
  "subject": "Your receipt",
  "html": "<p>Thanks for your order.</p>"
}

Production checklist

  • Domain added and verified in Groundmail
  • from uses verified domain
  • API key only in secrets, not in frontend
  • Bounce/complaint handling via webhooks if needed