n8n-nodes-cakemail

Community node for integrating Cakemail with n8n, providing complete email marketing automation capabilities.

Features

• 22 Resources with 130+ operations
• Full Cakemail API coverage
• Webhook trigger support
• Multi-tenant account management
• Built with TypeScript and the official @cakemail-org/cakemail-sdk

Supported Resources

• Campaigns - Create, send, and manage email campaigns
• Contacts - Manage contact lists and subscriber data
• Lists - Create and organize mailing lists
• Segments - Target specific audiences with segments
• Templates - Design and manage email templates
• Forms - Create signup and preference forms
• Senders - Manage sender profiles
• Domains - Configure and verify sending domains
• DKIM - Set up email authentication
• Relays - Configure SMTP relay settings
• Links - Track and manage campaign links
• Logs - Access email delivery logs
• Users - Manage team members and permissions
• Sub-accounts - Handle multi-tenant account structures
• Tokens - Manage API tokens
• Interests - Set up subscriber interest categories
• Tags - Organize contacts with tags
• Suppressed Emails - Manage bounce and unsubscribe lists
• And more...

Installation

Community Node (Recommended)

Install directly in n8n:

1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-cakemail
4. Click Install

Manual Installation

For self-hosted n8n instances:

npm install n8n-nodes-cakemail

Restart your n8n instance after installation.

Configuration

1. Create Cakemail Credentials

1. In n8n, go to Credentials > New
2. Search for Cakemail API
3. Enter your credentials:
   • Email: Your Cakemail account email
   • Password: Your Cakemail account password
   • API Base URL (optional): Default is https://api.cakemail.dev

2. Test Connection

Click Test to verify your credentials are working correctly.

Usage

Basic Workflow Example

Here's a simple workflow to create a contact:

1. Add a Cakemail node to your workflow
2. Select your Cakemail credentials
3. Choose Resource: Contact
4. Choose Operation: Create
5. Fill in the required fields:
   • List ID
   • Email address
   • Additional contact details

Using the Trigger Node

The Cakemail Trigger node allows you to react to webhook events:

1. Add a Cakemail Trigger node
2. Select your Cakemail credentials
3. Choose the event type to listen for:
   • Campaign sent
   • Contact subscribed
   • Contact unsubscribed
   • Email bounced
   • Link clicked
   • And more...

Common Use Cases

Automated Welcome Email

Manual Trigger → Create Contact → Send Campaign

Sync Contacts from CRM

Schedule Trigger → Get CRM Contacts → Create/Update Cakemail Contacts

Bounce Handling

Cakemail Trigger (Bounce) → Update CRM → Send Notification

Development

Prerequisites

• Node.js 18+
• npm or yarn
• n8n (for testing)

Setup

# Clone the repository
git clone https://github.com/cakemail/n8n-nodes-cakemail.git
cd n8n-nodes-cakemail

# Install dependencies
npm install

# Build the project
npm run build

Development Workflow

# Clean previous builds
npm run clean

# Build TypeScript
npm run build

# Run tests
npm run test

# Lint code
npm run lint

Project Structure

n8n-nodes-cakemail/
├── credentials/
│   └── CakemailApi.credentials.ts    # API authentication
├── nodes/
│   ├── Cakemail/
│   │   ├── Cakemail.node.ts          # Main node
│   │   ├── cakemail.svg              # Node icon
│   │   └── resources/                # Resource operations
│   │       ├── sender.operations.ts
│   │       ├── template.operations.ts
│   │       ├── domain.operations.ts
│   │       └── ... (13 more resources)
│   └── CakemailTrigger/
│       └── CakemailTrigger.node.ts   # Webhook trigger node
├── src/                               # Source utilities
├── dist/                              # Compiled output
└── package.json

Testing Locally with n8n

To test your changes in a local n8n instance:

# 1. Build the package
npm run build

# 2. Link the package globally
npm link

# 3. In your n8n installation directory
cd /path/to/n8n
npm link n8n-nodes-cakemail

# 4. Restart n8n
n8n start

Resources

• Cakemail API Documentation
• Cakemail SDK
• n8n Documentation
• n8n Community Nodes

Support

For issues, questions, or contributions:

• GitHub Issues
• Cakemail Support

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

MIT License - see the LICENSE file for details.

Keywords

n8n n8n-community-node-package cakemail email marketing automation multi-tenant

---

Made with ❤️ by Cakemail