n8n-nodes-mautic-advanced 0.7.2 → 0.7.6

package/README.md

@@ -1,353 +1,353 @@
-# 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
-
-### 👤 Users
-- **Create** a new Mautic user (administrator) with role, password, and profile fields
-- **Get** a user by ID
-- **Get Many** users with basic filtering and pagination
-- **Update** user details including role, profile fields, and password
-- **Delete** a user
-
-### 🔐 Roles
-- **Create** a new role with name, description, and permissions
-- **Get** a role by ID
-- **Get Many** roles with filtering and pagination
-- **Update** role details including permissions
-- **Delete** a role
-
-### 📈 Stats
-- **Get Available Tables** to list all statistical tables and their columns
-- **Get Stats** from a specific table with filtering, ordering, and pagination
-
-## 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
+
+### 👤 Users
+- **Create** a new Mautic user (administrator) with role, password, and profile fields
+- **Get** a user by ID
+- **Get Many** users with basic filtering and pagination
+- **Update** user details including role, profile fields, and password
+- **Delete** a user
+
+### 🔐 Roles
+- **Create** a new role with name, description, and permissions
+- **Get** a role by ID
+- **Get Many** roles with filtering and pagination
+- **Update** role details including permissions
+- **Delete** a role
+
+### 📈 Stats
+- **Get Available Tables** to list all statistical tables and their columns
+- **Get Stats** from a specific table with filtering, ordering, and pagination
+
+## 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/ContactDescription.js

@@ -1452,6 +1452,36 @@ exports.contactFields = [
             },
         },
         options: [
+            {
+                displayName: 'Any Do Not Contact Only',
+                name: 'anyDncOnly',
+                type: 'boolean',
+                default: false,
+                description: 'Return only contacts with any Do Not Contact enabled',
+            },
+            {
+                displayName: 'Campaign(s)',
+                name: 'campaigns',
+                type: 'multiOptions',
+                typeOptions: {
+                    loadOptionsMethod: 'getCampaigns',
+                },
+                displayOptions: {
+                    show: {
+                        '/resource': ['contact'],
+                        '/operation': ['getAll'],
+                    },
+                },
+                default: [],
+                description: 'Filter contacts by membership in one or more campaigns. Uses Mautic search syntax (campaign:id) under the hood.',
+            },
+            {
+                displayName: 'Email Do Not Contact Only',
+                name: 'emailDncOnly',
+                type: 'boolean',
+                default: false,
+                description: 'Return only contacts with Email Do Not Contact enabled',
+            },
             {
                 displayName: 'Fields to Return',
                 name: 'fieldsToReturn',
@@ -1463,17 +1493,17 @@ exports.contactFields = [
                 description: 'Select which fields to include in the output. Leave empty to return all fields.',
             },
             {
-                displayName: 'Search',
-                name: 'search',
-                type: 'string',
+                displayName: 'Minimal',
+                name: 'minimal',
+                type: 'boolean',
                 displayOptions: {
                     show: {
                         '/resource': ['contact'],
                         '/operation': ['getAll'],
                     },
                 },
-                default: '',
-                description: 'String or search command to filter entities by',
+                default: false,
+                description: 'Whether to return array of entities without additional lists in it',
             },
             {
                 displayName: 'Order By',
@@ -1511,6 +1541,22 @@ exports.contactFields = [
                 ],
                 description: 'Sort direction: ASC or DESC',
             },
+            {
+                displayName: 'Owner(s)',
+                name: 'owners',
+                type: 'multiOptions',
+                typeOptions: {
+                    loadOptionsMethod: 'getOwners',
+                },
+                displayOptions: {
+                    show: {
+                        '/resource': ['contact'],
+                        '/operation': ['getAll'],
+                    },
+                },
+                default: [],
+                description: 'Filter contacts by owner (assigned user). Uses Mautic search syntax (owner:id) under the hood.',
+            },
             {
                 displayName: 'Published Only',
                 name: 'publishedOnly',
@@ -1525,17 +1571,125 @@ exports.contactFields = [
                 description: 'Whether to return currently published entities',
             },
             {
-                displayName: 'Minimal',
-                name: 'minimal',
+                displayName: 'RAW Data',
+                name: 'rawData',
                 type: 'boolean',
+                default: true,
+                description: 'By default only the data of the fields get returned. If this option gets set the RAW response with all data gets returned.',
+            },
+            {
+                displayName: 'Search',
+                name: 'search',
+                type: 'string',
                 displayOptions: {
                     show: {
                         '/resource': ['contact'],
                         '/operation': ['getAll'],
                     },
                 },
+                default: '',
+                description: 'String or search command to filter entities by',
+            },
+            {
+                displayName: 'Segment Match Type',
+                name: 'segmentMatchType',
+                type: 'options',
+                options: [
+                    {
+                        name: 'Any Selected Segment',
+                        value: 'any',
+                    },
+                    {
+                        name: 'All Selected Segments',
+                        value: 'all',
+                    },
+                ],
+                displayOptions: {
+                    show: {
+                        '/resource': ['contact'],
+                        '/operation': ['getAll'],
+                    },
+                },
+                default: 'any',
+                description: 'When multiple segments are selected, choose whether to return contacts in any selected segment or only those that are in all selected segments.',
+            },
+            {
+                displayName: 'Segment(s)',
+                name: 'segments',
+                type: 'multiOptions',
+                typeOptions: {
+                    loadOptionsMethod: 'getSegmentAliases',
+                },
+                displayOptions: {
+                    show: {
+                        '/resource': ['contact'],
+                        '/operation': ['getAll'],
+                    },
+                },
+                default: [],
+                description: 'Filter contacts by membership in one or more segments. Uses Mautic search syntax (segment:alias) under the hood.',
+            },
+            {
+                displayName: 'SMS Do Not Contact Only',
+                name: 'smsDncOnly',
+                type: 'boolean',
                 default: false,
-                description: 'Whether to return array of entities without additional lists in it',
+                description: 'Return only contacts with SMS Do Not Contact enabled',
+            },
+            {
+                displayName: 'Stage(s)',
+                name: 'stages',
+                type: 'multiOptions',
+                typeOptions: {
+                    loadOptionsMethod: 'getStages',
+                },
+                displayOptions: {
+                    show: {
+                        '/resource': ['contact'],
+                        '/operation': ['getAll'],
+                    },
+                },
+                default: [],
+                description: 'Filter contacts by one or more stages. Uses Mautic search syntax (stage:id) under the hood.',
+            },
+            {
+                displayName: 'Tag Match Type',
+                name: 'tagMatchType',
+                type: 'options',
+                options: [
+                    {
+                        name: 'Any Selected Tag',
+                        value: 'any',
+                    },
+                    {
+                        name: 'All Selected Tags',
+                        value: 'all',
+                    },
+                ],
+                displayOptions: {
+                    show: {
+                        '/resource': ['contact'],
+                        '/operation': ['getAll'],
+                    },
+                },
+                default: 'any',
+                description: 'When multiple tags are selected, choose whether to return contacts with any selected tag or only those with all selected tags.',
+            },
+            {
+                displayName: 'Tag(s)',
+                name: 'tags',
+                type: 'multiOptions',
+                typeOptions: {
+                    loadOptionsMethod: 'getTags',
+                },
+                displayOptions: {
+                    show: {
+                        '/resource': ['contact'],
+                        '/operation': ['getAll'],
+                    },
+                },
+                default: [],
+                description: 'Filter contacts by one or more tags. Uses Mautic search syntax (tag:name) under the hood.',
             },
             {
                 displayName: 'Where',
@@ -1664,34 +1818,6 @@ exports.contactFields = [
                     },
                 ],
             },
-            {
-                displayName: 'Email Do Not Contact Only',
-                name: 'emailDncOnly',
-                type: 'boolean',
-                default: false,
-                description: 'Return only contacts with Email Do Not Contact enabled',
-            },
-            {
-                displayName: 'SMS Do Not Contact Only',
-                name: 'smsDncOnly',
-                type: 'boolean',
-                default: false,
-                description: 'Return only contacts with SMS Do Not Contact enabled',
-            },
-            {
-                displayName: 'Any Do Not Contact Only',
-                name: 'anyDncOnly',
-                type: 'boolean',
-                default: false,
-                description: 'Return only contacts with any Do Not Contact enabled',
-            },
-            {
-                displayName: 'RAW Data',
-                name: 'rawData',
-                type: 'boolean',
-                default: true,
-                description: 'By default only the data of the fields get returned. If this option gets set the RAW response with all data gets returned.',
-            },
         ],
     },
     /* -------------------------------------------------------------------------- */

package/dist/nodes/MauticAdvanced/MauticAdvanced.node.js

@@ -37,7 +37,7 @@ class MauticAdvanced {
         this.description = {
             displayName: 'Mautic Advanced',
             name: 'mauticAdvanced',
-            icon: 'file:MauticAdvanced.svg',
+            icon: 'file:mauticadvanced.svg',
             group: ['output'],
             version: 1,
             subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
@@ -297,7 +297,7 @@ class MauticAdvanced {
                 // select them easily
                 async getSegments() {
                     const returnData = [];
-                    const segments = await GenericFunctions_1.mauticApiRequestAllItems.call(this, 'segments', 'GET', '/segments');
+                    const segments = await GenericFunctions_1.mauticApiRequestAllItems.call(this, 'lists', 'GET', '/segments');
                     for (const segment of segments) {
                         returnData.push({
                             name: segment.name,
@@ -306,6 +306,37 @@ class MauticAdvanced {
                     }
                     return returnData;
                 },
+                // Get all the available segments (by alias) for search filtering
+                async getSegmentAliases() {
+                    const returnData = [];
+                    const segments = await GenericFunctions_1.mauticApiRequestAllItems.call(this, 'lists', 'GET', '/segments');
+                    for (const segment of segments) {
+                        // Use alias if available, otherwise skip (alias is required for search syntax)
+                        const alias = segment.alias || segment.id?.toString();
+                        if (alias) {
+                            returnData.push({
+                                name: segment.name || alias,
+                                value: alias,
+                            });
+                        }
+                    }
+                    return returnData;
+                },
+                // Get all the available owners (users) for filtering
+                async getOwners() {
+                    const returnData = [];
+                    const response = await GenericFunctions_1.mauticApiRequest.call(this, 'GET', '/contacts/list/owners');
+                    const owners = response || [];
+                    for (const owner of owners) {
+                        returnData.push({
+                            name: `${owner.firstName || ''} ${owner.lastName || ''}`.trim() ||
+                                owner.username ||
+                                `User ${owner.id}`,
+                            value: owner.id,
+                        });
+                    }
+                    return returnData;
+                },
                 // Get all the available campaings to display them to user so that they can
                 // select them easily
                 async getCampaigns() {

package/dist/nodes/MauticAdvanced/MauticAdvancedTrigger.node.js

@@ -8,7 +8,7 @@ class MauticAdvancedTrigger {
         this.description = {
             displayName: 'Mautic Advanced Trigger',
             name: 'mauticAdvancedTrigger',
-            icon: 'file:MauticAdvanced.svg',
+            icon: 'file:mauticadvanced.svg',
             group: ['trigger'],
             version: 1,
             description: 'Handle Mautic events via webhooks',

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>;
+<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

@@ -165,6 +165,59 @@ async function getAllContacts(context, itemIndex) {
     const returnAll = (0, ApiHelpers_1.getOptionalParam)(context, 'returnAll', itemIndex, false);
     const options = (0, ApiHelpers_1.getOptionalParam)(context, 'options', itemIndex, {});
     const qs = (0, DataHelpers_1.buildQueryFromOptions)(options);
+    // Build search expression from structured filters
+    const searchParts = [];
+    // Segment filter
+    const segments = options.segments;
+    if (Array.isArray(segments) && segments.length > 0) {
+        const segmentMatchType = options.segmentMatchType || 'any';
+        const filterExpr = buildSearchFilterExpression(segments, 'segment', segmentMatchType);
+        if (filterExpr)
+            searchParts.push(filterExpr);
+    }
+    // Tag filter
+    const tags = options.tags;
+    if (Array.isArray(tags) && tags.length > 0) {
+        const tagMatchType = options.tagMatchType || 'any';
+        const filterExpr = buildSearchFilterExpression(tags, 'tag', tagMatchType);
+        if (filterExpr)
+            searchParts.push(filterExpr);
+    }
+    // Owner filter (always OR for multiple owners - a contact can only have one owner)
+    const owners = options.owners;
+    if (Array.isArray(owners) && owners.length > 0) {
+        const filterExpr = buildSearchFilterExpression(owners, 'owner', 'any');
+        if (filterExpr)
+            searchParts.push(filterExpr);
+    }
+    // Stage filter (always OR for multiple stages - a contact can only be in one stage)
+    const stages = options.stages;
+    if (Array.isArray(stages) && stages.length > 0) {
+        const filterExpr = buildSearchFilterExpression(stages, 'stage', 'any');
+        if (filterExpr)
+            searchParts.push(filterExpr);
+    }
+    // Campaign filter (OR for multiple campaigns)
+    const campaigns = options.campaigns;
+    if (Array.isArray(campaigns) && campaigns.length > 0) {
+        const filterExpr = buildSearchFilterExpression(campaigns, 'campaign', 'any');
+        if (filterExpr)
+            searchParts.push(filterExpr);
+    }
+    // Combine all structured filters with AND
+    if (searchParts.length > 0) {
+        const structuredSearch = searchParts.length === 1
+            ? searchParts[0]
+            : searchParts.map((part) => `(${part})`).join(' AND ');
+        // Merge with raw search if provided
+        const rawSearch = options.search;
+        if (rawSearch && rawSearch.trim().length > 0) {
+            qs.search = `${structuredSearch} AND (${rawSearch})`;
+        }
+        else {
+            qs.search = structuredSearch;
+        }
+    }
     if (!qs.orderBy)
         qs.orderBy = 'id';
     if (!qs.orderByDir)
@@ -421,6 +474,26 @@ async function getAllContactActivity(context, itemIndex) {
     const result = await (0, ApiHelpers_1.makePaginatedRequest)(context, 'events', 'GET', `/contacts/activity`, {}, qs);
     return (0, DataHelpers_1.convertNumericStrings)(result);
 }
+/**
+ * Build a Mautic search filter expression from an array of values.
+ * @param values Array of filter values (IDs, aliases, or names)
+ * @param filterType The Mautic search filter type (e.g., 'segment', 'tag', 'owner', 'stage', 'campaign')
+ * @param matchType 'any' for OR logic, 'all' for AND logic
+ * @returns The search expression string, or empty string if no valid values
+ */
+function buildSearchFilterExpression(values, filterType, matchType) {
+    const filters = values
+        .map((value) => `${filterType}:${value}`)
+        .filter((expr) => expr.trim().length > 0);
+    if (filters.length === 0) {
+        return '';
+    }
+    if (filters.length === 1) {
+        return filters[0];
+    }
+    const operator = matchType === 'all' ? ' AND ' : ' OR ';
+    return filters.join(operator);
+}
 function normalizeTagsInput(tagsInput) {
     // Handle different input formats for tags
     // If it's already an array of strings, return as is

package/package.json

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