npm package: @inventivehq/n8n-nodes-pushmail
Description: n8n community node for PushMail.dev — API-first email infrastructure
Author: Sean Conroy
Latest version: 0.1.3

# n8n-nodes-pushmail

[n8n](https://n8n.io/) community node for [PushMail.dev](https://pushmail.dev) — API-first email infrastructure for developers.

Send transactional emails, manage contacts and lists, enroll contacts in automated drip sequences, and trigger workflows on email events like opens, clicks, bounces, and unsubscribes — all from n8n. Pay-per-email pricing, no monthly subscriber fees.

## Why PushMail?

Unlike basic email nodes that only send messages, PushMail gives you the full email lifecycle in n8n:

- **Drip sequences** — enroll contacts in multi-step automated email sequences
- **Contact management** — create, update, and organize contacts across lists
- **Real-time webhooks** — trigger workflows on delivery, open, click, bounce, spam report, and unsubscribe events
- **Template system** — use saved templates with variable substitution
- **Multi-site support** — manage multiple brands/domains from one account
- **Pay-per-email** — no monthly fees per subscriber, just pay for what you send

## Installation

In your n8n instance, go to **Settings > Community Nodes > Install** and enter:

```
n8n-nodes-pushmail
```

## Credentials

You need a PushMail API key to connect. Generate one in your [PushMail dashboard](https://pushmail.dev/dashboard) under **API Keys**.

1. In n8n, create a new **PushMail API** credential
2. Paste your API key (format: `pm_live_...`)
3. The base URL defaults to `https://pushmail.dev`

## Nodes

### PushMail (Action)

Perform operations on your PushMail account:

| Resource | Operation | Description |
|----------|-----------|-------------|
| Contact | Create/Update | Create a new contact or update an existing one |
| Contact | Get | Retrieve a contact by ID |
| Contact | List | List contacts with optional filtering |
| Email | Send | Send a transactional email (template or inline HTML) |
| List | Get All | Get all contact lists |
| List | Add Contact | Add a contact to a list |
| Sequence | Enroll | Enroll a contact in a drip sequence |

Dynamic dropdowns are provided for sites, lists, templates, and sequences.

### PushMail Trigger (Webhook)

Start a workflow when email events occur. Supported events:

- **Delivered** — email successfully delivered
- **Bounce** — email bounced
- **Open** — recipient opened the email
- **Click** — recipient clicked a link
- **Spam Report** — recipient marked as spam
- **Unsubscribe** — recipient unsubscribed

Webhooks are automatically created when you activate a workflow and removed when you deactivate it.

## Example Use Cases

- **Re-engage bounced contacts** — trigger a workflow on bounce to update a CRM or notify your team
- **Lead scoring** — increment a score in your database every time a contact opens or clicks
- **Onboarding automation** — when a user signs up (via webhook from your app), create a contact and enroll them in a welcome drip sequence
- **Win-back campaigns** — trigger a workflow when a contact unsubscribes to send a feedback survey via another channel

## Resources

- [PushMail Documentation](https://pushmail.dev/docs)
- [PushMail API Reference](https://pushmail.dev/docs/api)
- [n8n Community Nodes Documentation](https://docs.n8n.io/integrations/community-nodes/)

## License

MIT