Description

!NetSendo Logo

n8n-nodes-netsendo


This is an n8n community node for NetSendo – a powerful, self-hosted email & SMS marketing automation platform.

Automate your marketing workflows directly within n8n, connecting NetSendo with thousands of other apps and services.

—

🚀 Features

| Feature | Description |
| ———————— | ———————————————————————– |
| 📧 Email Marketing | Send single & batch emails with scheduling, mailbox selection |
| 📱 SMS Marketing | Send single & batch SMS with scheduling and subscriber linking |
| 👤 Subscribers | Full CRUD operations for subscriber management |
| 🔄 Webhook Triggers | React to subscriber, email and SMS events in real-time |
| 📋 Dynamic Dropdowns | Auto-loads contact lists, mailboxes, and subscribers with phone numbers |

—

📦 Installation

Via n8n UI (Recommended)

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

Via npm

npm install n8n-nodes-netsendo

Via Docker

Add to your docker-compose.yml:

environment:
  - N8NCOMMUNITYPACKAGES=n8n-nodes-netsendo

—

🔧 Development Setup

To test the node locally before publishing:

1. Clone and install dependencies

git clone https://github.com/NetSendo/n8n-nodes-netsendo.git
cd n8n-nodes-netsendo
npm install

2. Build the project

npm run build

3. Link to your local n8n

In the node project directory
npm link
In your n8n installation directory (find with: which n8n)
cd ~/.n8n
npm link n8n-nodes-netsendo

4. Start n8n

n8n start

5. Alternative: Use n8n-node dev command

npm run dev

This will watch for changes and automatically rebuild.

—

🔐 Credentials Setup

1. In n8n, go to Credentials > Create New
2. Search for NetSendo API
3. Enter:
– Base URL: Your NetSendo installation URL (e.g., https://your-domain.com)
– API Key: Your API token from Settings > API Keys (format: nslive...)

> Required permissions:
>
> – For subscribers/lists: subscribers:read, subscribers:write, lists:read
> – For email: email:read, email:write
> – For SMS: sms:read, sms:write
> – For triggers: webhooks:read, webhooks:write

—

🛠️ Operations

⚡ NetSendo Trigger

Start workflows automatically when events occur.

Subscriber Events:

• subscriber.created / subscriber.updated / subscriber.deleted
• subscriber.subscribed / subscriber.unsubscribed / subscriber.bounced
• subscriber.tagadded / subscriber.tagremoved

Email Events:

• email.queued – Email message queued for sending

SMS Events:

• sms.queued – SMS message queued for sending
• sms.sent – SMS successfully delivered
• sms.failed – SMS delivery failed

—

📧 Resource: Email

| Operation | Description |
| —————— | ———————————— |
| Send | Send a single email message |
| Send Batch | Send email to a contact list or tags |
| Get Status | Check delivery status of an email |
| List Mailboxes | Get available sender mailboxes |

✨ Smart Features:

• Mailbox Selection: Choose sender mailbox from dropdown
• Schedule Email: Send messages at a specific time
• Batch Targeting: Target by list, tags, or subscriber IDs
• Excluded Lists: Exclude specific lists from batch sends

Send Email Example:

{
	"email": "user@example.com",
	"subject": "Welcome!",
	"content": "
Hello!
Welcome to our newsletter.
",
	"schedule_at": "2025-01-01T10:00:00Z"
}

—

📂 Resource: List

| Operation | Description |
| ——————- | ——————————— |
| Get Many | Retrieve all contact lists |
| Get | Get a specific list by ID |
| Get Subscribers | Fetch all subscribers from a list |

—

👤 Resource: Subscriber

| Operation | Description |
| —————- | ————————————————– |
| Get Many | List subscribers with filters (status, pagination) |
| Get | Get subscriber by ID |
| Get by Email | Find subscriber by email address |
| Create | Add new subscriber |
| Update | Update subscriber data |
| Delete | Remove subscriber (soft delete) |

—

🏷️ Resource: Tag

| Operation | Description |
| ———— | ————————— |
| Get Many | Retrieve all available tags |
| Get | Get tag details by ID |

—

📱 Resource: SMS

| Operation | Description |
| —————— | ————————————— |
| Send | Send a single SMS message |
| Send Batch | Send SMS to a contact list or tag group |
| Get Status | Check delivery status of an SMS |
| List Providers | Get available SMS providers |

✨ Smart Features:

• Dynamic Subscriber Selection: Select a contact list → get dropdown with subscribers who have phone numbers
• Schedule SMS: Send messages at a specific time using the Schedule At field
• Subscriber Linking: Link SMS to existing subscriber for tracking

Send SMS Example:

{
	"phone_number": "+48123456789",
	"message": "Hello from NetSendo!",
	"schedule_at": "2025-01-01T10:00:00Z"
}

—

📚 Resources

| Resource | Link |
| ——————– | ————————————————– |
| 🌐 NetSendo Website | netsendo.com |
| 📖 NetSendo Docs | docs.netsendo.com |
| 💻 GitHub Repository | github.com/NetSendo |
| 🔗 n8n Website | n8n.io |

—

🤝 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 amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

—

📄 License

This project is licensed under the MIT License – see the LICENSE file for details.

—

💬 Support

Need help? We’re here for you!

| Channel | Link |
| ———————- | ———————————————————————————————— |
| 🐛 Report a Bug | Submit Bug Report |
| 💡 Feature Request | Request a Feature |
| 📧 Email Support | grzegorzciupek@gmail.com |
| 💻 Node Issues | n8n-nodes-netsendo Issues |

—

Built with ❤️ for the NetSendo Community.