n8n-nodes-mautic-advanced 0.4.0 → 0.4.1

package/README.md

@@ -1,335 +1,335 @@
-# n8n Mautic Advanced Node
-
-[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-Support-yellow.svg)](https://buymeacoffee.com/msoukhomlinov)
-
-Enhanced n8n node for Mautic with comprehensive API coverage including tags, campaigns, categories, notifications, and advanced contact management.
-
-## 📋 Table of Contents
-
-- [What Makes This "Advanced"?](#what-makes-this-advanced)
-- [Features](#features)
-- [Supported Resources and Operations](#supported-resources-and-operations)
-- [Installation](#installation)
-- [Authentication](#authentication)
-- [Advanced Features](#advanced-features)
-- [Usage Examples](#usage-examples)
-- [Development](#development)
-- [Troubleshooting](#troubleshooting)
-- [Changelog](#changelog)
-- [Support](#support)
-- [License](#license)
-
-## What Makes This "Advanced"?
-
-This enhanced version extends the standard n8n Mautic node with:
-
-- **🏷️ Complete Tag Management**: Full CRUD operations for tags (missing in the standard node)
-- **📊 Campaign Operations**: Create, clone, update, and manage campaigns
-- **📁 Category Management**: Handle categories with bundle and color support
-- **🔔 Notification Management**: Full CRUD operations for notifications with scheduling and language support
-- **🔗 Advanced Relationship Management**: Sophisticated contact-to-campaign and contact-to-company associations
-- **📧 Enhanced Email Operations**: Segment-based email sending capabilities
-- **👥 Extended Contact Operations**: UTM tag management, activity tracking, device information, and notes
-- **🏢 Complete Company Management**: Full company lifecycle with custom fields and address support
-- **🔍 Advanced Filtering**: Where filters, DNC filtering, and field selection
-- **📅 Smart Date Handling**: Automatic date formatting for Mautic API compatibility
-
-## Features
-
-### 🚀 Core Features
-- **Comprehensive API Coverage**: All major Mautic API endpoints supported
-- **Advanced Filtering**: Where filters with nested conditions (andX/orX)
-- **DNC Management**: Filter contacts by Do Not Contact status
-- **Field Selection**: Choose which fields to return for Contact operations
-- **Pagination Support**: Automatic handling of large datasets
-- **Custom Fields**: Full support for custom field management
-- **Error Handling**: Robust error handling and validation
-
-### 🔐 Authentication
-- **API Credentials**: Simple API key authentication
-- **OAuth2**: Full OAuth2 flow support for secure authentication
-
-### 📊 Data Management
-- **RAW Data Options**: Control data output format
-- **System Fields**: Built-in support for system fields
-- **Date Formatting**: Automatic UTC date formatting
-- **Deduplication**: Prevents duplicate records in paginated results
-
-## Supported Resources and Operations
-
-### 🏢 Companies
-- **Create** a new company with full address and custom field support
-- **Get** a company by ID
-- **Get Many** companies with filtering and pagination
-- **Update** company details
-- **Delete** a company
-
-### 👥 Contacts (Enhanced)
-- **Create** a new contact with extensive field options
-- **Get** a contact by ID with field selection
-- **Get Many** contacts with advanced filtering and DNC options
-- **Update** contact details
-- **Delete** a contact
-- **Delete Batch** multiple contacts in one operation
-- **Send Email** to a contact
-- **Edit Contact Points** (add/subtract points)
-- **Edit Do Not Contact List** (add/remove from DNC)
-- **Add/Remove UTM Tags** for tracking
-- **Get Notes** associated with a contact
-- **Get Activity** history for a contact
-- **Get Companies** associated with a contact
-- **Get Devices** used by a contact
-
-### 🏷️ Tags
-- **Create** a new tag with description
-- **Get** a tag by ID
-- **Get Many** tags with search capabilities
-- **Update** tag name and description
-- **Delete** a tag
-
-### 📊 Campaigns
-- **Create** a new campaign
-- **Get** a campaign by ID
-- **Get All** campaigns
-- **Update** campaign details
-- **Delete** a campaign
-- **Clone** an existing campaign
-- **Get Contacts** in a campaign
-
-### 📁 Categories
-- **Create** a new category with bundle and color settings
-- **Get** a category by ID
-- **Get Many** categories
-- **Update** category details
-- **Delete** a category
-
-### 🔔 Notifications
-- **Create** a new notification with scheduling and language support
-- **Get** a notification by ID
-- **Get Many** notifications with filtering
-- **Update** notification details
-- **Delete** a notification
-
-### 📋 Segments
-- **Create** a new segment
-- **Get** a segment by ID
-- **Get Many** segments with filtering
-- **Update** segment details
-- **Delete** a segment
-
-### 🔗 Relationship Management
-- **Campaign Contact**: Add/remove contacts to/from campaigns
-- **Company Contact**: Add/remove contacts to/from companies
-- **Contact Segment**: Add/remove contacts to/from segments
-
-### 📧 Email Operations
-- **Segment Email**: Send emails to segments
-
-## Installation
-
-### Method 1: npm (Recommended)
-```bash
-npm install n8n-nodes-mautic-advanced
-```
-
-### Method 2: Manual Installation
-1. Clone this repository:
-   ```bash
-   git clone https://github.com/msoukhomlinov/n8n-nodes-mautic-advanced.git
-   cd n8n-nodes-mautic-advanced
-   ```
-
-2. Install dependencies:
-   ```bash
-   npm install
-   ```
-
-3. Build the node:
-   ```bash
-   npm run build
-   ```
-
-4. Link to your n8n installation:
-   ```bash
-   npm link
-   cd /path/to/your/n8n/installation
-   npm link n8n-nodes-mautic-advanced
-   ```
-
-## Authentication
-
-### API Credentials
-1. Go to your Mautic instance
-2. Navigate to **Settings** → **API Credentials**
-3. Create a new API credential
-4. Copy the **Public Key** and **Secret Key**
-5. In n8n, add a new Mautic Advanced credential
-6. Select **Credentials** authentication method
-7. Enter your Mautic URL, Public Key, and Secret Key
-
-### OAuth2
-1. In n8n, add a new Mautic Advanced credential
-2. Select **OAuth2** authentication method
-3. Enter your Mautic URL
-4. Follow the OAuth2 authorization flow
-
-## Advanced Features
-
-### Where Filters
-Advanced filtering for Contact > Get Many operations:
-- **Nested Conditions**: Support for andX/orX logical operators
-- **Multiple Expressions**: eq, neq, lt, lte, gt, gte, between, in, isNull, isNotNull
-- **Custom Fields**: Filter by any custom or system field
-- **Date Filtering**: Automatic date formatting for Mautic API
-
-### DNC Filtering
-Filter contacts by Do Not Contact status:
-- **Email DNC Only**: Contacts with email DNC enabled
-- **SMS DNC Only**: Contacts with SMS DNC enabled
-- **Any DNC Only**: Contacts with any DNC enabled
-
-### Field Selection
-Choose which fields to return for Contact operations:
-- **System Fields**: date_added, date_modified, id, owner_id
-- **Custom Fields**: Any custom field defined in Mautic
-- **All Fields**: Return complete contact data
-
-### Date Formatting
-Automatic date formatting for known date fields:
-- **Format**: YYYY-MM-DD HH:mm:ss UTC
-- **Compatibility**: Ensures Mautic API compatibility
-- **Fields**: date_added, date_modified, lastActive, etc.
-
-## Usage Examples
-
-### Create a Contact with Tags
-```javascript
-// Contact Create operation
-{
-  "email": "john.doe@example.com",
-  "firstName": "John",
-  "lastName": "Doe",
-  "additionalFields": {
-    "tags": ["customer", "vip"],
-    "company": "Example Corp",
-    "phone": "+1234567890"
-  }
-}
-```
-
-### Filter Contacts with Where Conditions
-```javascript
-// Contact Get Many with Where filter
-{
-  "where": {
-    "conditions": [
-      {
-        "col": "email",
-        "expr": "neq",
-        "val": ""
-      },
-      {
-        "col": "date_added",
-        "expr": "gte",
-        "val": "2024-01-01"
-      }
-    ]
-  }
-}
-```
-
-### Send Email to Segment
-```javascript
-// Segment Email operation
-{
-  "segmentId": "123",
-  "emailId": "456",
-  "options": {
-    "sendToNewOnly": true
-  }
-}
-```
-
-## Development
-
-### Prerequisites
-- Node.js 16+
-- npm or yarn
-- n8n development environment
-
-### Commands
-```bash
-# Install dependencies
-npm install
-
-# Build the node
-npm run build
-
-# Watch for changes (development)
-npm run dev
-
-# Check for linting errors
-npm run lint
-
-# Fix linting errors
-npm run lint:fix
-
-# Format code
-npm run format
-```
-
-### Project Structure
-```
-├── credentials/          # Authentication credentials
-├── nodes/               # Node implementations
-│   └── MauticAdvanced/  # Main node files
-├── dist/                # Compiled output
-├── package.json         # Project configuration
-└── README.md           # This file
-```
-
-## Troubleshooting
-
-### Common Issues
-
-#### "Could not get parameter 'options'" Error
-**Cause**: Missing Options parameter in node definition
-**Solution**: Update to latest version (0.3.2+) which includes all required Options parameters
-
-#### Authentication Errors
-**Cause**: Incorrect credentials or URL
-**Solution**: 
-- Verify Mautic URL format (https://your-mautic.com)
-- Check API credentials are active
-- Ensure proper permissions for API access
-
-#### Date Filter Issues
-**Cause**: Incorrect date format
-**Solution**: Use YYYY-MM-DD format for date filters
-
-#### Pagination Problems
-**Cause**: Large datasets causing timeouts
-**Solution**: Use "Return All" option or set appropriate limits
-
-### Getting Help
-1. Check the [Changelog](CHANGELOG.md) for recent fixes
-2. Search existing [Issues](https://github.com/msoukhomlinov/n8n-nodes-mautic-advanced/issues)
-3. Create a new issue with detailed information
-
-## Support
-
-If you find this node helpful and want to support its ongoing development, you can buy me a coffee:
-
-[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-Support-yellow.svg)](https://buymeacoffee.com/msoukhomlinov)
-
-Your support helps maintain this project and develop new features.
-
-## License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
-## Credits
-
-- Built with [n8n](https://n8n.io/) workflow automation platform
-- Uses [change-case](https://github.com/blakeembrey/change-case) for string manipulation
-- Icons and design inspired by n8n community standards
+# n8n Mautic Advanced Node
+
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-Support-yellow.svg)](https://buymeacoffee.com/msoukhomlinov)
+
+Enhanced n8n node for Mautic with comprehensive API coverage including tags, campaigns, categories, notifications, and advanced contact management.
+
+## 📋 Table of Contents
+
+- [What Makes This "Advanced"?](#what-makes-this-advanced)
+- [Features](#features)
+- [Supported Resources and Operations](#supported-resources-and-operations)
+- [Installation](#installation)
+- [Authentication](#authentication)
+- [Advanced Features](#advanced-features)
+- [Usage Examples](#usage-examples)
+- [Development](#development)
+- [Troubleshooting](#troubleshooting)
+- [Changelog](#changelog)
+- [Support](#support)
+- [License](#license)
+
+## What Makes This "Advanced"?
+
+This enhanced version extends the standard n8n Mautic node with:
+
+- **🏷️ Complete Tag Management**: Full CRUD operations for tags (missing in the standard node)
+- **📊 Campaign Operations**: Create, clone, update, and manage campaigns
+- **📁 Category Management**: Handle categories with bundle and color support
+- **🔔 Notification Management**: Full CRUD operations for notifications with scheduling and language support
+- **🔗 Advanced Relationship Management**: Sophisticated contact-to-campaign and contact-to-company associations
+- **📧 Enhanced Email Operations**: Segment-based email sending capabilities
+- **👥 Extended Contact Operations**: UTM tag management, activity tracking, device information, and notes
+- **🏢 Complete Company Management**: Full company lifecycle with custom fields and address support
+- **🔍 Advanced Filtering**: Where filters, DNC filtering, and field selection
+- **📅 Smart Date Handling**: Automatic date formatting for Mautic API compatibility
+
+## Features
+
+### 🚀 Core Features
+- **Comprehensive API Coverage**: All major Mautic API endpoints supported
+- **Advanced Filtering**: Where filters with nested conditions (andX/orX)
+- **DNC Management**: Filter contacts by Do Not Contact status
+- **Field Selection**: Choose which fields to return for Contact operations
+- **Pagination Support**: Automatic handling of large datasets
+- **Custom Fields**: Full support for custom field management
+- **Error Handling**: Robust error handling and validation
+
+### 🔐 Authentication
+- **API Credentials**: Simple API key authentication
+- **OAuth2**: Full OAuth2 flow support for secure authentication
+
+### 📊 Data Management
+- **RAW Data Options**: Control data output format
+- **System Fields**: Built-in support for system fields
+- **Date Formatting**: Automatic UTC date formatting
+- **Deduplication**: Prevents duplicate records in paginated results
+
+## Supported Resources and Operations
+
+### 🏢 Companies
+- **Create** a new company with full address and custom field support
+- **Get** a company by ID
+- **Get Many** companies with filtering and pagination
+- **Update** company details
+- **Delete** a company
+
+### 👥 Contacts (Enhanced)
+- **Create** a new contact with extensive field options
+- **Get** a contact by ID with field selection
+- **Get Many** contacts with advanced filtering and DNC options
+- **Update** contact details
+- **Delete** a contact
+- **Delete Batch** multiple contacts in one operation
+- **Send Email** to a contact
+- **Edit Contact Points** (add/subtract points)
+- **Edit Do Not Contact List** (add/remove from DNC)
+- **Add/Remove UTM Tags** for tracking
+- **Get Notes** associated with a contact
+- **Get Activity** history for a contact
+- **Get Companies** associated with a contact
+- **Get Devices** used by a contact
+
+### 🏷️ Tags
+- **Create** a new tag with description
+- **Get** a tag by ID
+- **Get Many** tags with search capabilities
+- **Update** tag name and description
+- **Delete** a tag
+
+### 📊 Campaigns
+- **Create** a new campaign
+- **Get** a campaign by ID
+- **Get All** campaigns
+- **Update** campaign details
+- **Delete** a campaign
+- **Clone** an existing campaign
+- **Get Contacts** in a campaign
+
+### 📁 Categories
+- **Create** a new category with bundle and color settings
+- **Get** a category by ID
+- **Get Many** categories
+- **Update** category details
+- **Delete** a category
+
+### 🔔 Notifications
+- **Create** a new notification with scheduling and language support
+- **Get** a notification by ID
+- **Get Many** notifications with filtering
+- **Update** notification details
+- **Delete** a notification
+
+### 📋 Segments
+- **Create** a new segment
+- **Get** a segment by ID
+- **Get Many** segments with filtering
+- **Update** segment details
+- **Delete** a segment
+
+### 🔗 Relationship Management
+- **Campaign Contact**: Add/remove contacts to/from campaigns
+- **Company Contact**: Add/remove contacts to/from companies
+- **Contact Segment**: Add/remove contacts to/from segments
+
+### 📧 Email Operations
+- **Segment Email**: Send emails to segments
+
+## Installation
+
+### Method 1: npm (Recommended)
+```bash
+npm install n8n-nodes-mautic-advanced
+```
+
+### Method 2: Manual Installation
+1. Clone this repository:
+   ```bash
+   git clone https://github.com/msoukhomlinov/n8n-nodes-mautic-advanced.git
+   cd n8n-nodes-mautic-advanced
+   ```
+
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+
+3. Build the node:
+   ```bash
+   npm run build
+   ```
+
+4. Link to your n8n installation:
+   ```bash
+   npm link
+   cd /path/to/your/n8n/installation
+   npm link n8n-nodes-mautic-advanced
+   ```
+
+## Authentication
+
+### API Credentials
+1. Go to your Mautic instance
+2. Navigate to **Settings** → **API Credentials**
+3. Create a new API credential
+4. Copy the **Public Key** and **Secret Key**
+5. In n8n, add a new Mautic Advanced credential
+6. Select **Credentials** authentication method
+7. Enter your Mautic URL, Public Key, and Secret Key
+
+### OAuth2
+1. In n8n, add a new Mautic Advanced credential
+2. Select **OAuth2** authentication method
+3. Enter your Mautic URL
+4. Follow the OAuth2 authorization flow
+
+## Advanced Features
+
+### Where Filters
+Advanced filtering for Contact > Get Many operations:
+- **Nested Conditions**: Support for andX/orX logical operators
+- **Multiple Expressions**: eq, neq, lt, lte, gt, gte, between, in, isNull, isNotNull
+- **Custom Fields**: Filter by any custom or system field
+- **Date Filtering**: Automatic date formatting for Mautic API
+
+### DNC Filtering
+Filter contacts by Do Not Contact status:
+- **Email DNC Only**: Contacts with email DNC enabled
+- **SMS DNC Only**: Contacts with SMS DNC enabled
+- **Any DNC Only**: Contacts with any DNC enabled
+
+### Field Selection
+Choose which fields to return for Contact operations:
+- **System Fields**: date_added, date_modified, id, owner_id
+- **Custom Fields**: Any custom field defined in Mautic
+- **All Fields**: Return complete contact data
+
+### Date Formatting
+Automatic date formatting for known date fields:
+- **Format**: YYYY-MM-DD HH:mm:ss UTC
+- **Compatibility**: Ensures Mautic API compatibility
+- **Fields**: date_added, date_modified, lastActive, etc.
+
+## Usage Examples
+
+### Create a Contact with Tags
+```javascript
+// Contact Create operation
+{
+  "email": "john.doe@example.com",
+  "firstName": "John",
+  "lastName": "Doe",
+  "additionalFields": {
+    "tags": ["customer", "vip"],
+    "company": "Example Corp",
+    "phone": "+1234567890"
+  }
+}
+```
+
+### Filter Contacts with Where Conditions
+```javascript
+// Contact Get Many with Where filter
+{
+  "where": {
+    "conditions": [
+      {
+        "col": "email",
+        "expr": "neq",
+        "val": ""
+      },
+      {
+        "col": "date_added",
+        "expr": "gte",
+        "val": "2024-01-01"
+      }
+    ]
+  }
+}
+```
+
+### Send Email to Segment
+```javascript
+// Segment Email operation
+{
+  "segmentId": "123",
+  "emailId": "456",
+  "options": {
+    "sendToNewOnly": true
+  }
+}
+```
+
+## Development
+
+### Prerequisites
+- Node.js 16+
+- npm or yarn
+- n8n development environment
+
+### Commands
+```bash
+# Install dependencies
+npm install
+
+# Build the node
+npm run build
+
+# Watch for changes (development)
+npm run dev
+
+# Check for linting errors
+npm run lint
+
+# Fix linting errors
+npm run lint:fix
+
+# Format code
+npm run format
+```
+
+### Project Structure
+```
+├── credentials/          # Authentication credentials
+├── nodes/               # Node implementations
+│   └── MauticAdvanced/  # Main node files
+├── dist/                # Compiled output
+├── package.json         # Project configuration
+└── README.md           # This file
+```
+
+## Troubleshooting
+
+### Common Issues
+
+#### "Could not get parameter 'options'" Error
+**Cause**: Missing Options parameter in node definition
+**Solution**: Update to latest version (0.3.2+) which includes all required Options parameters
+
+#### Authentication Errors
+**Cause**: Incorrect credentials or URL
+**Solution**: 
+- Verify Mautic URL format (https://your-mautic.com)
+- Check API credentials are active
+- Ensure proper permissions for API access
+
+#### Date Filter Issues
+**Cause**: Incorrect date format
+**Solution**: Use YYYY-MM-DD format for date filters
+
+#### Pagination Problems
+**Cause**: Large datasets causing timeouts
+**Solution**: Use "Return All" option or set appropriate limits
+
+### Getting Help
+1. Check the [Changelog](CHANGELOG.md) for recent fixes
+2. Search existing [Issues](https://github.com/msoukhomlinov/n8n-nodes-mautic-advanced/issues)
+3. Create a new issue with detailed information
+
+## Support
+
+If you find this node helpful and want to support its ongoing development, you can buy me a coffee:
+
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-Support-yellow.svg)](https://buymeacoffee.com/msoukhomlinov)
+
+Your support helps maintain this project and develop new features.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Credits
+
+- Built with [n8n](https://n8n.io/) workflow automation platform
+- Uses [change-case](https://github.com/blakeembrey/change-case) for string manipulation
+- Icons and design inspired by n8n community standards

package/dist/nodes/MauticAdvanced/CategoryDescription.js

@@ -63,12 +63,12 @@ exports.categoryFields = [
             },
         },
         default: '',
-        description: 'The title of the category to create',
+        description: 'The title or name of the category',
     },
     {
         displayName: 'Bundle',
         name: 'bundle',
-        type: 'string',
+        type: 'options',
         required: true,
         displayOptions: {
             show: {
@@ -76,8 +76,75 @@ exports.categoryFields = [
                 operation: ['create'],
             },
         },
-        default: '',
-        description: 'The bundle where the category will be available',
+        options: [
+            {
+                name: 'Global',
+                value: 'global',
+                description: 'Available across all Mautic elements',
+            },
+            {
+                name: 'Asset',
+                value: 'asset',
+                description: 'For downloadable assets',
+            },
+            {
+                name: 'Campaign',
+                value: 'campaign',
+                description: 'For marketing campaigns',
+            },
+            {
+                name: 'Email',
+                value: 'email',
+                description: 'For email templates',
+            },
+            {
+                name: 'Focus Items',
+                value: 'plugin:focus',
+                description: 'For focus items',
+            },
+            {
+                name: 'Form',
+                value: 'form',
+                description: 'For forms',
+            },
+            {
+                name: 'Marketing Messages',
+                value: 'messages',
+                description: 'For marketing messages',
+            },
+            {
+                name: 'Page',
+                value: 'page',
+                description: 'For landing pages',
+            },
+            {
+                name: 'Point',
+                value: 'point',
+                description: 'For point actions',
+            },
+            {
+                name: 'Segment',
+                value: 'segment',
+                description: 'For contact segments',
+            },
+            {
+                name: 'Text Message',
+                value: 'sms',
+                description: 'For SMS/text messages',
+            },
+            {
+                name: 'Social Monitoring',
+                value: 'plugin:mauticSocial',
+                description: 'For social monitoring',
+            },
+            {
+                name: 'Stage',
+                value: 'stage',
+                description: 'For contact stages',
+            },
+        ],
+        default: 'global',
+        description: 'The bundle where the category will be available. Determines which Mautic elements can use this category',
     },
     {
         displayName: 'Description',
@@ -90,12 +157,12 @@ exports.categoryFields = [
             },
         },
         default: '',
-        description: 'The description of the category',
+        description: 'Optional description of the category to help identify its purpose',
     },
     {
         displayName: 'Color',
         name: 'color',
-        type: 'string',
+        type: 'color',
         displayOptions: {
             show: {
                 resource: ['category'],
@@ -103,7 +170,7 @@ exports.categoryFields = [
             },
         },
         default: '',
-        description: 'The color of the category',
+        description: 'Color for visual organisation and identification of the category in Mautic',
     },
     /* -------------------------------------------------------------------------- */
     /*                                category:update                             */
@@ -153,28 +220,95 @@ exports.categoryFields = [
                 name: 'title',
                 type: 'string',
                 default: '',
-                description: 'The new title of the category',
+                description: 'The new title or name of the category',
             },
             {
                 displayName: 'Bundle',
                 name: 'bundle',
-                type: 'string',
+                type: 'options',
                 default: '',
-                description: 'The new bundle of the category',
+                options: [
+                    {
+                        name: 'Global',
+                        value: 'global',
+                        description: 'Available across all Mautic elements',
+                    },
+                    {
+                        name: 'Asset',
+                        value: 'asset',
+                        description: 'For downloadable assets',
+                    },
+                    {
+                        name: 'Campaign',
+                        value: 'campaign',
+                        description: 'For marketing campaigns',
+                    },
+                    {
+                        name: 'Email',
+                        value: 'email',
+                        description: 'For email templates',
+                    },
+                    {
+                        name: 'Focus Items',
+                        value: 'plugin:focus',
+                        description: 'For focus items',
+                    },
+                    {
+                        name: 'Form',
+                        value: 'form',
+                        description: 'For forms',
+                    },
+                    {
+                        name: 'Marketing Messages',
+                        value: 'messages',
+                        description: 'For marketing messages',
+                    },
+                    {
+                        name: 'Page',
+                        value: 'page',
+                        description: 'For landing pages',
+                    },
+                    {
+                        name: 'Point',
+                        value: 'point',
+                        description: 'For point actions',
+                    },
+                    {
+                        name: 'Segment',
+                        value: 'segment',
+                        description: 'For contact segments',
+                    },
+                    {
+                        name: 'Text Message',
+                        value: 'sms',
+                        description: 'For SMS/text messages',
+                    },
+                    {
+                        name: 'Social Monitoring',
+                        value: 'plugin:mauticSocial',
+                        description: 'For social monitoring',
+                    },
+                    {
+                        name: 'Stage',
+                        value: 'stage',
+                        description: 'For contact stages',
+                    },
+                ],
+                description: 'The bundle where the category will be available. Determines which Mautic elements can use this category',
             },
             {
                 displayName: 'Description',
                 name: 'description',
                 type: 'string',
                 default: '',
-                description: 'The new description of the category',
+                description: 'Optional description of the category to help identify its purpose',
             },
             {
                 displayName: 'Color',
                 name: 'color',
-                type: 'string',
+                type: 'color',
                 default: '',
-                description: 'The new color of the category',
+                description: 'Color for visual organisation and identification of the category in Mautic',
             },
         ],
     },

package/dist/nodes/MauticAdvanced/ContactDescription.js

@@ -1727,6 +1727,58 @@ exports.contactFields = [
         },
         default: '',
     },
+    {
+        displayName: 'Tokens',
+        name: 'tokensUi',
+        type: 'fixedCollection',
+        typeOptions: {
+            multipleValues: true,
+        },
+        placeholder: 'Add Token',
+        description: 'Custom tokens to pass to the email template. These will be available as {token_name} in your email template.',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['contact'],
+                operation: ['sendEmail'],
+            },
+        },
+        options: [
+            {
+                name: 'tokenValues',
+                displayName: 'Token',
+                values: [
+                    {
+                        displayName: 'Token Name',
+                        name: 'tokenKey',
+                        type: 'string',
+                        default: '',
+                        description: 'The token name (e.g., "order_id", "customer_name")',
+                    },
+                    {
+                        displayName: 'Token Value',
+                        name: 'tokenValue',
+                        type: 'string',
+                        default: '',
+                        description: 'The token value (e.g., "12345", "John")',
+                    },
+                ],
+            },
+        ],
+    },
+    {
+        displayName: 'Asset Attachments',
+        name: 'assetAttachments',
+        type: 'string',
+        description: 'Comma-separated list of asset IDs to attach to the email',
+        default: '',
+        displayOptions: {
+            show: {
+                resource: ['contact'],
+                operation: ['sendEmail'],
+            },
+        },
+    },
     /* -------------------------------------------------------------------------- */
     /*                                contact:getNotes                            */
     /* -------------------------------------------------------------------------- */

package/dist/nodes/MauticAdvanced/{MauticAdvanced.svg → mauticadvanced.svg}

@@ -1,10 +1,10 @@
-<svg xmlns="http://www.w3.org/2000/svg" xml:space="preserve" width="349.779" height="349.779">
-  <path
-    fill="#FFF"
-    d="M174.89 349.779C78.612 349.779 0 271.462 0 174.89S78.612 0 174.89 0c23.26 0 45.931 4.417 67.129 13.543 5.889 2.65 8.833 9.422 6.478 15.605-2.649 5.888-9.421 8.833-15.604 6.477-18.549-7.655-37.98-11.482-58.002-11.482-83.323 0-151.041 67.718-151.041 151.041s67.717 151.041 151.04 151.041 151.041-67.718 151.041-151.041c0-17.96-2.944-35.332-9.127-51.819-2.355-6.183.883-12.955 7.066-15.31s12.954.883 15.31 7.066c7.066 19.138 10.6 39.453 10.6 60.063-.001 95.983-78.318 174.595-174.89 174.595"
-  />
-  <path
-    fill="#FDB933"
-    d="m251.44 156.93-27.086 28.264 15.015 63.302h34.153zm-11.187-83.618 9.421 9.422-74.784 79.201-63.891-65.658-36.803 152.219h34.154l20.315-84.5 46.225 50.347 98.927-107.76 9.422 9.716 9.421-53.292z"
-  />
+<svg xmlns="http://www.w3.org/2000/svg" xml:space="preserve" width="349.779" height="349.779">
+  <path
+    fill="#FFF"
+    d="M174.89 349.779C78.612 349.779 0 271.462 0 174.89S78.612 0 174.89 0c23.26 0 45.931 4.417 67.129 13.543 5.889 2.65 8.833 9.422 6.478 15.605-2.649 5.888-9.421 8.833-15.604 6.477-18.549-7.655-37.98-11.482-58.002-11.482-83.323 0-151.041 67.718-151.041 151.041s67.717 151.041 151.04 151.041 151.041-67.718 151.041-151.041c0-17.96-2.944-35.332-9.127-51.819-2.355-6.183.883-12.955 7.066-15.31s12.954.883 15.31 7.066c7.066 19.138 10.6 39.453 10.6 60.063-.001 95.983-78.318 174.595-174.89 174.595"
+  />
+  <path
+    fill="#FDB933"
+    d="m251.44 156.93-27.086 28.264 15.015 63.302h34.153zm-11.187-83.618 9.421 9.422-74.784 79.201-63.891-65.658-36.803 152.219h34.154l20.315-84.5 46.225 50.347 98.927-107.76 9.422 9.716 9.421-53.292z"
+  />
 </svg>

package/dist/nodes/MauticAdvanced/operations/ContactOperations.js

@@ -220,8 +220,33 @@ async function deleteContact(context, itemIndex) {
 }
 async function sendEmailToContact(context, itemIndex) {
     const contactId = (0, ApiHelpers_1.getRequiredParam)(context, 'contactId', itemIndex);
-    const emailId = (0, ApiHelpers_1.getRequiredParam)(context, 'emailId', itemIndex);
-    const response = await (0, ApiHelpers_1.makeApiRequest)(context, 'POST', `/emails/${emailId}/contact/${contactId}/send`);
+    const emailId = (0, ApiHelpers_1.getRequiredParam)(context, 'campaignEmailId', itemIndex);
+    const tokensUi = (0, ApiHelpers_1.getOptionalParam)(context, 'tokensUi', itemIndex, {});
+    const assetAttachments = (0, ApiHelpers_1.getOptionalParam)(context, 'assetAttachments', itemIndex, '');
+    // Build request body
+    const body = {};
+    // Process tokens from key-value pairs UI
+    if (tokensUi?.tokenValues && Array.isArray(tokensUi.tokenValues)) {
+        const tokens = {};
+        for (const tokenItem of tokensUi.tokenValues) {
+            if (tokenItem.tokenKey && tokenItem.tokenValue !== undefined) {
+                tokens[tokenItem.tokenKey] = tokenItem.tokenValue;
+            }
+        }
+        if (Object.keys(tokens).length > 0) {
+            body.tokens = tokens;
+        }
+    }
+    // Process asset attachments
+    if (assetAttachments && assetAttachments.trim()) {
+        body.assetAttachments = assetAttachments
+            .split(',')
+            .map((id) => id.trim())
+            .filter((id) => id.length > 0);
+    }
+    // Only send body if it has content
+    const requestBody = Object.keys(body).length > 0 ? body : {};
+    const response = await (0, ApiHelpers_1.makeApiRequest)(context, 'POST', `/emails/${emailId}/contact/${contactId}/send`, requestBody);
     return response;
 }
 async function editContactPoints(context, itemIndex) {

package/dist/nodes/MauticAdvanced/operations/MiscellaneousOperations.js

@@ -198,8 +198,11 @@ async function createCategory(context, itemIndex) {
     if (description)
         body.description = description;
     const color = (0, ApiHelpers_1.getOptionalParam)(context, 'color', itemIndex, '');
-    if (color)
-        body.color = color;
+    if (color) {
+        // Mautic API expects hex color without # prefix (e.g., "b36262")
+        // n8n color picker returns with # prefix, so we strip it if present
+        body.color = color.startsWith('#') ? color.substring(1) : color;
+    }
     const response = await (0, ApiHelpers_1.makeApiRequest)(context, 'POST', '/categories/new', body);
     return response.category;
 }
@@ -212,8 +215,12 @@ async function updateCategory(context, itemIndex) {
         body.title = updateFields.title;
     if (updateFields.description)
         body.description = updateFields.description;
-    if (updateFields.color)
-        body.color = updateFields.color;
+    if (updateFields.color) {
+        // Mautic API expects hex color without # prefix (e.g., "b36262")
+        // n8n color picker returns with # prefix, so we strip it if present
+        const color = updateFields.color;
+        body.color = color.startsWith('#') ? color.substring(1) : color;
+    }
     if (updateFields.bundle)
         body.bundle = updateFields.bundle;
     const method = createIfNotFound ? 'PUT' : 'PATCH';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-mautic-advanced",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Enhanced n8n node for Mautic with comprehensive API coverage including tags, campaigns, categories, and advanced contact management",
   "keywords": [
     "n8n",