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 | |----------|-----------|-----| | Email | Send | POST /emails | | Email | Get | GET /emails/{id} | | Email | Get Many | GET /emails |

Example: send a welcome email

1. Add a trigger, such as Webhook or Form Trigger.
2. Add a Groundmail node, connect it, and pick your credentials.
3. Set Resource to Email and Operation to Send:

| Field | Value | |-------|-------| | From | [email protected] | | 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