groundmail

n8n community node for Groundmail (transactional email API)

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.3
Author: Groundmail

Available Nodes

Documentation generating…

Documentation

Groundmail

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.

npm License: MIT

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
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 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

Discussion