Enhanced n8n node for Mautic with comprehensive API coverage including tags, campaigns, categories, and advanced contact management
npm install n8n-nodes-mautic-advanced
> Note: This is an unofficial community node, not affiliated with or endorsed by n8n GmbH. It was built on the back of n8n's official Mautic node because the official node does not provide the API coverage needed for many real-world Mautic workflows (e.g. notes, users, roles, stats, themes, emails, fields, notifications, advanced filtering, and more).
Enhanced n8n node for Mautic with comprehensive API coverage including tags, campaigns, categories, notifications, and advanced contact management.
- What Makes This "Advanced"?
- Features
- Supported Resources and Operations
- Installation
- Authentication
- Advanced Features
- Usage Examples
- Development
- Troubleshooting
- Changelog
- Support
- License
The official n8n Mautic node covers basic contact and company operations but lacks support for many Mautic API endpoints. This unofficial community node extends that foundation 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
bash
npm install n8n-nodes-mautic-advanced
`$3
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
$3
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$3
1. In n8n, add a new Mautic Advanced credential
2. Select OAuth2 authentication method
3. Enter your Mautic URL
4. Follow the OAuth2 authorization flowAdvanced Features
$3
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$3
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$3
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$3
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
$3
`javascript
// Contact Create operation
{
"email": "john.doe@example.com",
"firstName": "John",
"lastName": "Doe",
"additionalFields": {
"tags": ["customer", "vip"],
"company": "Example Corp",
"phone": "+1234567890"
}
}
`$3
`javascript
// Contact Get Many with Where filter
{
"where": {
"conditions": [
{
"col": "email",
"expr": "neq",
"val": ""
},
{
"col": "date_added",
"expr": "gte",
"val": "2024-01-01"
}
]
}
}
`$3
`javascript
// Segment Email operation
{
"segmentId": "123",
"emailId": "456",
"options": {
"sendToNewOnly": true
}
}
`Development
$3
- Node.js 16+
- npm or yarn
- n8n development environment$3
`bash
Install dependencies
npm installBuild the node
npm run buildWatch for changes (development)
npm run devCheck for linting errors
npm run lintFix linting errors
npm run lint:fixFormat code
npm run format
`$3
`
āāā credentials/ # Authentication credentials
āāā nodes/ # Node implementations
ā āāā MauticAdvanced/ # Main node files
āāā dist/ # Compiled output
āāā package.json # Project configuration
āāā README.md # This file
``#### "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
If you find this node helpful and want to support its ongoing development, you can buy me a coffee:

Your support helps maintain this project and develop new features.
This project is licensed under the MIT License - see the LICENSE file for details.
- Built on top of n8n's official Mautic node ā extended with additional API coverage where the official node falls short
- Built with n8n workflow automation platform
- Uses change-case for string manipulation
- Uses a custom icon to distinguish from the official n8n Mautic node