Works with Strapi 5 and Strapi 4.

Install

npm install strapi-provider-email-groundmail

GROUNDMAIL_API_KEY=gm_your_key_here

Configure

// config/plugins.ts
export default ({ env }) => ({
  email: {
    config: {
      provider: 'strapi-provider-email-groundmail',
      providerOptions: {
        apiKey: env('GROUNDMAIL_API_KEY'),
      },
      settings: {
        defaultFrom: 'Acme <[email protected]>',
        defaultReplyTo: '[email protected]',
      },
    },
  },
})

The From address must be on a domain you have verified in Groundmail.

Send

await strapi.plugin('email').service('email').send({
  to: '[email protected]',
  subject: 'Welcome to Acme',
  html: '<p>Thanks for signing up.</p>',
  text: 'Thanks for signing up.',
})

Besides Strapi's from, to, cc, bcc, replyTo, subject, text and html, a send can pass:

| Field | Purpose | |-------|---------| | attachments | [{ filename, content, contentType }], content as a string or Buffer (set encoding: 'base64' for base64 strings) | | template | { id, variables } to send a Groundmail template instead of html/text | | tags | { name: value } tags for filtering and webhooks | | headers | Extra email headers | | idempotencyKey | Send once, even when your code retries | | scheduledAt | ISO 8601 time to send later |

Options

| providerOptions | Purpose | |-------------------|---------| | apiKey | Groundmail API key. Falls back to GROUNDMAIL_API_KEY | | baseUrl | Override the API base URL |

Contributing

Found a bug or want something added? Open an issue. This code is published here on each release, so we port fixes rather than merging pull requests directly. The HTTP client itself is the groundmail package.

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