Groundmail

groundmail payload

by Groundmail
Email
v?
MIT

Overview

Summary generated from the README

Provides an email adapter for Payload that delivers transactional email through the Groundmail HTTP API. It is set as the email option in the Payload config, with a default from address and name. It handles authentication mail and calls to payload.sendEmail(). It requires the groundmail package and an API key, which can be supplied through an environment variable.

Features

  • Email adapter configured through the Payload email option
  • Sends auth emails and payload.sendEmail() messages via HTTP API
  • Configurable default from address and from name
  • API key read from an environment variable or passed explicitly
  • Also exposed through a payload entry point in the groundmail package

Use cases

  • Send Payload password reset and verification emails through Groundmail
  • Deliver transactional email from Payload without SMTP or Nodemailer

From the author

Payload CMS email adapter for Groundmail transactional email

Installation

npm i groundmail-payload

0

Stars

0

Forks

0

Open Issues

3 days ago

Last Updated

2.6k

Weekly Downloads

v0.15.12

npm Version

2.3 KB

Unpacked Size

0

Dependencies

GitHub stars

Trends appear after 7 days of data. Daily snapshots have not started yet.

npm weekly downloads

Trends appear after 7 days of data. Daily snapshots have not started yet.

Each point is npm's rolling 7-day download count.

Health Score

82/100Excellent

Composite score based on GitHub activity, stars, npm downloads, publish recency, dependency count, and package size.

Badge for your README

Payload Directory health badge
Markdown
[![Payload Directory](https://payloaddirectory.dev/badge/1423954331-root.svg)](https://payloaddirectory.dev/plugins/1423954331-root)
HTML
<a href="https://payloaddirectory.dev/plugins/1423954331-root"><img src="https://payloaddirectory.dev/badge/1423954331-root.svg" alt="Payload Directory"></a>
Updated Oct 18, 2026Created Oct 18, 2026Published Oct 19, 2026

README

groundmail-payload

Payload CMS email adapter for Groundmail — auth mail and payload.sendEmail() over the HTTP API.

Install

npm install groundmail-payload groundmail
GROUNDMAIL_API_KEY=gm_your_key_here

Usage

import { buildConfig } from 'payload'
import { groundmailAdapter } from 'groundmail-payload'

export default buildConfig({
  email: groundmailAdapter({
    defaultFromAddress: '[email protected]',
    defaultFromName: 'Acme',
    // apiKey: process.env.GROUNDMAIL_API_KEY,
  }),
  // ...collections, etc.
})

Also available as import { groundmailAdapter } from 'groundmail/payload'.

Prefer Nodemailer? Use groundmail-nodemailer with @payloadcms/email-nodemailer instead.

Docs

https://docs.groundmail.dev/guides/payload

License

MIT

Tags

Similar plugins