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:
  - N8N_COMMUNITY_PACKAGES=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: ns_live_...)

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.tag_added / subscriber.tag_removed

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": "[email protected]",
	"subject": "Welcome!",
	"content": "<h1>Hello!</h1><p>Welcome to our newsletter.</p>",
	"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) |

✨ Client Data Forwarding (New in v1.3.0):

When creating subscribers via Webhook, forward real user data:

| Field | Expression Example | Description | | --------------- | ---------------------------------------- | ------------------------------- | | IP Address | {{ $json.headers["x-forwarded-for"] }} | Real IP address of the end user | | User-Agent | {{ $json.headers["user-agent"] }} | Browser User-Agent string | | Device Type | desktop, mobile, or tablet | Type of device |

🔍 Resource: Pixel (Tracking)

| Operation | Description | | ---------------------- | ------------------------------------ | | Track Event | Track a single pixel event | | Batch Track Events | Track multiple events in one request |

Track Event Fields:

• user_id (required) - ID of the user/subscriber
• visitor_token (required) - Unique visitor token
• event_type (required) - Type of event (e.g., page_view, click, purchase)
• page_url (optional) - URL of the page where the event occurred
• client_ip (optional) - Real IP address of the client

Track Event Example:

{
	"user_id": 1,
	"visitor_token": "abc-123-def",
	"event_type": "page_view",
	"page_url": "https://example.com/product",
	"client_ip": "192.168.1.100"
}

🏷️ 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 | [email protected] | | 💻 Node Issues | n8n-nodes-netsendo Issues |

Built with ❤️ for the NetSendo Community.