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": "user@example.com",
	"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	grzegorzciupek@gmail.com
💻 Node Issues	n8n-nodes-netsendo Issues

---

Built with ❤️ for the NetSendo Community.