Package Information
Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.3
Author: Groundmail
Documentation
Groundmail for n8n
An n8n community node for the Groundmail transactional email API.
Send welcome emails, alerts and receipts from any workflow, then check their delivery status.
Docs · Get a free account · groundmail.dev
Install
In n8n, open Settings → Community Nodes → Install and enter:
n8n-nodes-groundmail
On self-hosted n8n you can also install it from npm:
npm install n8n-nodes-groundmail
The node has no runtime dependencies. It calls the Groundmail API directly.
Credentials
Create Groundmail API credentials in n8n:
| Field | Value |
|---|---|
| API Key | Your gm_ key from the Groundmail dashboard |
| API Base URL | https://api.groundmail.dev |
Operations
| Resource | Operation | API |
|---|---|---|
| Send | POST /emails |
|
| Get | GET /emails/{id} |
|
| Get Many | GET /emails |
Example: send a welcome email
- Add a trigger, such as Webhook or Form Trigger.
- Add a Groundmail node, connect it, and pick your credentials.
- Set Resource to Email and Operation to Send:
| Field | Value |
|---|---|
| From | welcome@yourdomain.com |
| To | ={{ $json.email }} |
| Subject | Welcome, {{ $json.name }}! |
| HTML | <h1>Welcome, {{ $json.name }}!</h1><p>Thanks for signing up.</p> |
| Text | Welcome, {{ $json.name }}! Thanks for signing up. |
Under Additional Fields you can set Reply To and a Tag. From must use a domain you have verified in Groundmail.
The node returns the API response:
{
"id": "msg_01h2x3y4z5a6b7c8d9e0f1g2h3",
"status": "sent"
}
Use Email → Get with that id to check delivery later, or Email → Get Many to list recent sends.
Why Groundmail
- Our own mail servers and IP space. Your password resets and receipts don't share a pool with bulk marketing senders.
- Transactional email only. No newsletters or cold outreach on the platform, which keeps the sending reputation clean.
- Start free. 3,000 emails a month on the Free plan; Pro is 50,000 emails for $20/month. Dedicated IPs on Scale.
- Built for code and for agents. REST API, SMTP, SDKs for Node, Python, Go, PHP and Ruby, a CLI, and an MCP server for Claude, ChatGPT and Cursor.
All Groundmail libraries
| Use | Package |
|---|---|
| Node.js / TypeScript | groundmail on npm |
| Python (Django), Go, Ruby (Rails Action Mailer) | Groundmail/groundmail-sdks |
| PHP | Groundmail/groundmail-php |
| Laravel | Groundmail/groundmail-laravel |
| Symfony Mailer | Groundmail/groundmail-symfony-mailer |
| Nodemailer | Groundmail/groundmail-nodemailer |
| NestJS | Groundmail/nestjs-groundmail |
| Strapi | Groundmail/strapi-provider-email-groundmail |
| Medusa | Groundmail/medusa-notification-groundmail |
| AdonisJS | Groundmail/adonisjs-groundmail |
| Phoenix (Swoosh) | Groundmail/swoosh_groundmail |
| CLI | groundmail-cli on npm |
| MCP server (Claude, ChatGPT, Cursor) | Groundmail/groundmail-mcp |
| Agent skills and Claude Code plugin | Groundmail/groundmail-skills |
| Email templates (React Email, MJML, HTML) | Groundmail/email-templates |
Website · Docs · Pricing · Sign up free