first commit

packages/nodes-base/nodes/Mautic/CampaignContactDescription.ts

@@ -0,0 +1,67 @@
+import type { INodeProperties } from 'n8n-workflow';
+
+export const campaignContactOperations: INodeProperties[] = [
+	{
+		displayName: 'Operation',
+		name: 'operation',
+		type: 'options',
+		noDataExpression: true,
+		displayOptions: {
+			show: {
+				resource: ['campaignContact'],
+			},
+		},
+		options: [
+			{
+				name: 'Add',
+				value: 'add',
+				description: 'Add contact to a campaign',
+				action: 'Add a campaign contact',
+			},
+			{
+				name: 'Remove',
+				value: 'remove',
+				description: 'Remove contact from a campaign',
+				action: 'Remove a campaign contact',
+			},
+		],
+		default: 'add',
+	},
+];
+
+export const campaignContactFields: INodeProperties[] = [
+	/* -------------------------------------------------------------------------- */
+	/*                               campaignContact:add                           */
+	/* -------------------------------------------------------------------------- */
+	{
+		displayName: 'Contact ID',
+		name: 'contactId',
+		type: 'string',
+		required: true,
+		displayOptions: {
+			show: {
+				resource: ['campaignContact'],
+				operation: ['add', 'remove'],
+			},
+		},
+		default: '',
+	},
+	{
+		displayName: 'Campaign Name or ID',
+		name: 'campaignId',
+		type: 'options',
+		description:
+			'Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>',
+		required: true,
+		displayOptions: {
+			show: {
+				resource: ['campaignContact'],
+				operation: ['add', 'remove'],
+			},
+		},
+		typeOptions: {
+			loadOptionsMethod: 'getCampaigns',
+		},
+		default: '',
+	},
+];

packages/nodes-base/nodes/Mautic/CompanyContactDescription.ts

@@ -0,0 +1,62 @@
+import type { INodeProperties } from 'n8n-workflow';
+
+export const companyContactOperations: INodeProperties[] = [
+	{
+		displayName: 'Operation',
+		name: 'operation',
+		type: 'options',
+		noDataExpression: true,
+		displayOptions: {
+			show: {
+				resource: ['companyContact'],
+			},
+		},
+		options: [
+			{
+				name: 'Add',
+				value: 'add',
+				description: 'Add contact to a company',
+				action: 'Add a company contact',
+			},
+			{
+				name: 'Remove',
+				value: 'remove',
+				description: 'Remove a contact from a company',
+				action: 'Remove a company contact',
+			},
+		],
+		default: 'create',
+	},
+];
+
+export const companyContactFields: INodeProperties[] = [
+	/* -------------------------------------------------------------------------- */
+	/*                                companyContact:add                          */
+	/* -------------------------------------------------------------------------- */
+	{
+		displayName: 'Contact ID',
+		name: 'contactId',
+		type: 'string',
+		displayOptions: {
+			show: {
+				resource: ['companyContact'],
+				operation: ['add', 'remove'],
+			},
+		},
+		default: '',
+		description: 'The ID of the contact',
+	},
+	{
+		displayName: 'Company ID',
+		name: 'companyId',
+		type: 'string',
+		displayOptions: {
+			show: {
+				resource: ['companyContact'],
+				operation: ['add', 'remove'],
+			},
+		},
+		default: '',
+		description: 'The ID of the company',
+	},
+];

packages/nodes-base/nodes/Mautic/CompanyDescription.ts

@@ -0,0 +1,619 @@
+import type { INodeProperties } from 'n8n-workflow';
+
+export const companyOperations: INodeProperties[] = [
+	{
+		displayName: 'Operation',
+		name: 'operation',
+		type: 'options',
+		noDataExpression: true,
+		displayOptions: {
+			show: {
+				resource: ['company'],
+			},
+		},
+		options: [
+			{
+				name: 'Create',
+				value: 'create',
+				description: 'Create a new company',
+				action: 'Create a company',
+			},
+			{
+				name: 'Delete',
+				value: 'delete',
+				description: 'Delete a company',
+				action: 'Delete a company',
+			},
+			{
+				name: 'Get',
+				value: 'get',
+				description: 'Get data of a company',
+				action: 'Get a company',
+			},
+			{
+				name: 'Get Many',
+				value: 'getAll',
+				description: 'Get data of many companies',
+				action: 'Get many companies',
+			},
+			{
+				name: 'Update',
+				value: 'update',
+				description: 'Update a company',
+				action: 'Update a company',
+			},
+		],
+		default: 'create',
+	},
+];
+
+export const companyFields: INodeProperties[] = [
+	/* -------------------------------------------------------------------------- */
+	/*                                company:create                              */
+	/* -------------------------------------------------------------------------- */
+	{
+		displayName: 'Company Name',
+		name: 'name',
+		type: 'string',
+		displayOptions: {
+			show: {
+				resource: ['company'],
+				operation: ['create'],
+			},
+		},
+		default: '',
+		description: 'The name of the company to create',
+	},
+	{
+		displayName: 'Simplify',
+		name: 'simple',
+		type: 'boolean',
+		displayOptions: {
+			show: {
+				resource: ['company'],
+				operation: ['create'],
+			},
+		},
+		default: true,
+		description: 'Whether to return a simplified version of the response instead of the raw data',
+	},
+	{
+		displayName: 'Additional Fields',
+		name: 'additionalFields',
+		type: 'collection',
+		placeholder: 'Add Field',
+		default: {},
+		displayOptions: {
+			show: {
+				resource: ['company'],
+				operation: ['create'],
+			},
+		},
+		options: [
+			{
+				displayName: 'Address',
+				name: 'addressUi',
+				placeholder: 'Address',
+				type: 'fixedCollection',
+				typeOptions: {
+					multipleValues: false,
+				},
+				default: {},
+				options: [
+					{
+						name: 'addressValues',
+						displayName: 'Address',
+						values: [
+							{
+								displayName: 'Address Line 1',
+								name: 'address1',
+								type: 'string',
+								default: '',
+							},
+							{
+								displayName: 'Address Line 2',
+								name: 'address2',
+								type: 'string',
+								default: '',
+							},
+							{
+								displayName: 'City',
+								name: 'city',
+								type: 'string',
+								default: '',
+							},
+							{
+								displayName: 'State',
+								name: 'state',
+								type: 'string',
+								default: '',
+							},
+							{
+								displayName: 'Country',
+								name: 'country',
+								type: 'string',
+								default: '',
+							},
+							{
+								displayName: 'Zip Code',
+								name: 'zipCode',
+								type: 'string',
+								default: '',
+							},
+						],
+					},
+				],
+			},
+			{
+				displayName: 'Annual Revenue',
+				name: 'annualRevenue',
+				type: 'number',
+				default: 0,
+			},
+			{
+				displayName: 'Company Email',
+				name: 'companyEmail',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'Custom Fields',
+				name: 'customFieldsUi',
+				placeholder: 'Add Custom Fields',
+				description: 'Adds a custom fields to set also values which have not been predefined',
+				type: 'fixedCollection',
+				typeOptions: {
+					multipleValues: true,
+				},
+				default: {},
+				options: [
+					{
+						name: 'customFieldValues',
+						displayName: 'Field',
+						values: [
+							{
+								displayName: 'Field Name or ID',
+								name: 'fieldId',
+								type: 'options',
+								typeOptions: {
+									loadOptionsMethod: 'getCompanyFields',
+								},
+								default: '',
+								description:
+									'ID of the field to set. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+							},
+							{
+								displayName: 'Field Value',
+								name: 'fieldValue',
+								type: 'string',
+								default: '',
+								description: 'Value of the field to set',
+							},
+						],
+					},
+				],
+			},
+			{
+				displayName: 'Description',
+				name: 'description',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'Fax',
+				name: 'fax',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'Industry Name or ID',
+				name: 'industry',
+				type: 'options',
+				description:
+					'Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>',
+				typeOptions: {
+					loadOptionsMethod: 'getIndustries',
+				},
+				default: '',
+			},
+			{
+				displayName: 'Is Published',
+				name: 'isPublished',
+				type: 'boolean',
+				default: false,
+			},
+			{
+				displayName: 'Number of Employees',
+				name: 'numberOfEmpoyees',
+				type: 'number',
+				default: 0,
+			},
+
+			{
+				displayName: 'Overwrite With Blank',
+				name: 'overwriteWithBlank',
+				type: 'boolean',
+				default: false,
+				description: 'Whether empty values are set to fields. Otherwise empty values are skipped.',
+			},
+			{
+				displayName: 'Phone',
+				name: 'phone',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'Website',
+				name: 'website',
+				type: 'string',
+				default: '',
+			},
+		],
+	},
+
+	/* -------------------------------------------------------------------------- */
+	/*                               company:update                               */
+	/* -------------------------------------------------------------------------- */
+	{
+		displayName: 'Company ID',
+		name: 'companyId',
+		type: 'string',
+		displayOptions: {
+			show: {
+				operation: ['update'],
+				resource: ['company'],
+			},
+		},
+		default: '',
+		description: 'The ID of the company to update',
+	},
+	{
+		displayName: 'Simplify',
+		name: 'simple',
+		type: 'boolean',
+		displayOptions: {
+			show: {
+				resource: ['company'],
+				operation: ['update'],
+			},
+		},
+		default: true,
+		description: 'Whether to return a simplified version of the response instead of the raw data',
+	},
+	{
+		displayName: 'Update Fields',
+		name: 'updateFields',
+		type: 'collection',
+		placeholder: 'Add Field',
+		default: {},
+		displayOptions: {
+			show: {
+				resource: ['company'],
+				operation: ['update'],
+			},
+		},
+		options: [
+			{
+				displayName: 'Address',
+				name: 'addressUi',
+				placeholder: 'Address',
+				type: 'fixedCollection',
+				typeOptions: {
+					multipleValues: false,
+				},
+				default: {},
+				options: [
+					{
+						name: 'addressValues',
+						displayName: 'Address',
+						values: [
+							{
+								displayName: 'Address Line 1',
+								name: 'address1',
+								type: 'string',
+								default: '',
+							},
+							{
+								displayName: 'Address Line 2',
+								name: 'address2',
+								type: 'string',
+								default: '',
+							},
+							{
+								displayName: 'City',
+								name: 'city',
+								type: 'string',
+								default: '',
+							},
+							{
+								displayName: 'State',
+								name: 'state',
+								type: 'string',
+								default: '',
+							},
+							{
+								displayName: 'Country',
+								name: 'country',
+								type: 'string',
+								default: '',
+							},
+							{
+								displayName: 'Zip Code',
+								name: 'zipCode',
+								type: 'string',
+								default: '',
+							},
+						],
+					},
+				],
+			},
+			{
+				displayName: 'Annual Revenue',
+				name: 'annualRevenue',
+				type: 'number',
+				default: 0,
+			},
+			{
+				displayName: 'Company Email',
+				name: 'companyEmail',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'Company Name',
+				name: 'name',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'Custom Fields',
+				name: 'customFieldsUi',
+				placeholder: 'Add Custom Fields',
+				description: 'Adds a custom fields to set also values which have not been predefined',
+				type: 'fixedCollection',
+				typeOptions: {
+					multipleValues: true,
+				},
+				default: {},
+				options: [
+					{
+						name: 'customFieldValues',
+						displayName: 'Field',
+						values: [
+							{
+								displayName: 'Field Name or ID',
+								name: 'fieldId',
+								type: 'options',
+								typeOptions: {
+									loadOptionsMethod: 'getCompanyFields',
+								},
+								default: '',
+								description:
+									'ID of the field to set. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+							},
+							{
+								displayName: 'Field Value',
+								name: 'fieldValue',
+								type: 'string',
+								default: '',
+								description: 'Value of the field to set',
+							},
+						],
+					},
+				],
+			},
+			{
+				displayName: 'Description',
+				name: 'description',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'Fax',
+				name: 'fax',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'Industry Name or ID',
+				name: 'industry',
+				type: 'options',
+				description:
+					'Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>',
+				typeOptions: {
+					loadOptionsMethod: 'getIndustries',
+				},
+				default: '',
+			},
+			{
+				displayName: 'Is Published',
+				name: 'isPublished',
+				type: 'boolean',
+				default: false,
+			},
+			{
+				displayName: 'Number of Employees',
+				name: 'numberOfEmpoyees',
+				type: 'number',
+				default: 0,
+			},
+
+			{
+				displayName: 'Overwrite With Blank',
+				name: 'overwriteWithBlank',
+				type: 'boolean',
+				default: false,
+				description: 'Whether empty values are set to fields. Otherwise, empty values are skipped.',
+			},
+			{
+				displayName: 'Phone',
+				name: 'phone',
+				type: 'string',
+				default: '',
+			},
+			{
+				displayName: 'Website',
+				name: 'website',
+				type: 'string',
+				default: '',
+			},
+		],
+	},
+
+	/* -------------------------------------------------------------------------- */
+	/*                                 company:get                                */
+	/* -------------------------------------------------------------------------- */
+	{
+		displayName: 'Company ID',
+		name: 'companyId',
+		type: 'string',
+		displayOptions: {
+			show: {
+				operation: ['get'],
+				resource: ['company'],
+			},
+		},
+		default: '',
+		description: 'The ID of the company to return',
+	},
+	{
+		displayName: 'Simplify',
+		name: 'simple',
+		type: 'boolean',
+		displayOptions: {
+			show: {
+				resource: ['company'],
+				operation: ['get'],
+			},
+		},
+		default: true,
+		description: 'Whether to return a simplified version of the response instead of the raw data',
+	},
+
+	/* -------------------------------------------------------------------------- */
+	/*                                company:getAll                              */
+	/* -------------------------------------------------------------------------- */
+	{
+		displayName: 'Return All',
+		name: 'returnAll',
+		type: 'boolean',
+		displayOptions: {
+			show: {
+				resource: ['company'],
+				operation: ['getAll'],
+			},
+		},
+		default: false,
+		description: 'Whether to return all results or only up to a given limit',
+	},
+	{
+		displayName: 'Limit',
+		name: 'limit',
+		type: 'number',
+		displayOptions: {
+			show: {
+				resource: ['company'],
+				operation: ['getAll'],
+				returnAll: [false],
+			},
+		},
+		typeOptions: {
+			minValue: 1,
+			maxValue: 30,
+		},
+		default: 30,
+		description: 'Max number of results to return',
+	},
+	{
+		displayName: 'Simplify',
+		name: 'simple',
+		type: 'boolean',
+		displayOptions: {
+			show: {
+				resource: ['company'],
+				operation: ['getAll'],
+			},
+		},
+		default: true,
+		description: 'Whether to return a simplified version of the response instead of the raw data',
+	},
+	{
+		displayName: 'Additional Fields',
+		name: 'additionalFields',
+		type: 'collection',
+		placeholder: 'Add Field',
+		default: {},
+		displayOptions: {
+			show: {
+				resource: ['company'],
+				operation: ['getAll'],
+			},
+		},
+		options: [
+			{
+				displayName: 'Order Direction',
+				name: 'orderByDir',
+				type: 'options',
+				options: [
+					{
+						name: 'ASC',
+						value: 'asc',
+					},
+					{
+						name: 'DESC',
+						value: 'desc',
+					},
+				],
+				default: '',
+				description: 'Sort direction: asc or desc',
+			},
+			{
+				displayName: 'Order By Name or ID',
+				name: 'orderBy',
+				type: 'options',
+				typeOptions: {
+					loadOptionsMethod: 'getCompanyFields',
+				},
+				default: '',
+				description:
+					'Column to sort by. Can use any column listed in the response. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+			},
+			{
+				displayName: 'Search',
+				name: 'search',
+				type: 'string',
+				default: '',
+				description: 'String or search command to filter entities by',
+			},
+		],
+	},
+	/* -------------------------------------------------------------------------- */
+	/*                               company:delete                               */
+	/* -------------------------------------------------------------------------- */
+	{
+		displayName: 'Company ID',
+		name: 'companyId',
+		type: 'string',
+		displayOptions: {
+			show: {
+				operation: ['delete'],
+				resource: ['company'],
+			},
+		},
+		default: '',
+		description: 'The ID of the company to delete',
+	},
+	{
+		displayName: 'Simplify',
+		name: 'simple',
+		type: 'boolean',
+		displayOptions: {
+			show: {
+				resource: ['company'],
+				operation: ['delete'],
+			},
+		},
+		default: true,
+		description: 'Whether to return a simplified version of the response instead of the raw data',
+	},
+];

packages/nodes-base/nodes/Mautic/ContactSegmentDescription.ts

@@ -0,0 +1,67 @@
+import type { INodeProperties } from 'n8n-workflow';
+
+export const contactSegmentOperations: INodeProperties[] = [
+	{
+		displayName: 'Operation',
+		name: 'operation',
+		type: 'options',
+		noDataExpression: true,
+		displayOptions: {
+			show: {
+				resource: ['contactSegment'],
+			},
+		},
+		options: [
+			{
+				name: 'Add',
+				value: 'add',
+				description: 'Add contact to a segment',
+				action: 'Add a contact to a segment',
+			},
+			{
+				name: 'Remove',
+				value: 'remove',
+				description: 'Remove contact from a segment',
+				action: 'Remove a contact from a segment',
+			},
+		],
+		default: 'add',
+	},
+];
+
+export const contactSegmentFields: INodeProperties[] = [
+	/* -------------------------------------------------------------------------- */
+	/*                               contactSegment:add                           */
+	/* -------------------------------------------------------------------------- */
+	{
+		displayName: 'Contact ID',
+		name: 'contactId',
+		type: 'string',
+		required: true,
+		displayOptions: {
+			show: {
+				resource: ['contactSegment'],
+				operation: ['add', 'remove'],
+			},
+		},
+		default: '',
+	},
+	{
+		displayName: 'Segment Name or ID',
+		name: 'segmentId',
+		type: 'options',
+		description:
+			'Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>',
+		required: true,
+		displayOptions: {
+			show: {
+				resource: ['contactSegment'],
+				operation: ['add', 'remove'],
+			},
+		},
+		typeOptions: {
+			loadOptionsMethod: 'getSegments',
+		},
+		default: '',
+	},
+];

packages/nodes-base/nodes/Mautic/GenericFunctions.ts

@@ -0,0 +1,102 @@
+import type {
+	IDataObject,
+	IExecuteFunctions,
+	IHookFunctions,
+	IHttpRequestMethods,
+	ILoadOptionsFunctions,
+	IRequestOptions,
+	JsonObject,
+} from 'n8n-workflow';
+import { NodeApiError } from 'n8n-workflow';
+
+export async function mauticApiRequest(
+	this: IHookFunctions | IExecuteFunctions | ILoadOptionsFunctions,
+	method: IHttpRequestMethods,
+	endpoint: string,
+
+	body: any = {},
+	query?: IDataObject,
+	uri?: string,
+): Promise<any> {
+	const authenticationMethod = this.getNodeParameter('authentication', 0, 'credentials') as string;
+
+	const options: IRequestOptions = {
+		headers: {},
+		method,
+		qs: query,
+		uri: uri || `/api${endpoint}`,
+		body,
+		json: true,
+	};
+
+	try {
+		let returnData;
+
+		if (authenticationMethod === 'credentials') {
+			const credentials = await this.getCredentials('mauticApi');
+			const baseUrl = credentials.url as string;
+
+			options.uri = `${baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl}${options.uri}`;
+			returnData = await this.helpers.requestWithAuthentication.call(this, 'mauticApi', options);
+		} else {
+			const credentials = await this.getCredentials('mauticOAuth2Api');
+			const baseUrl = credentials.url as string;
+
+			options.uri = `${baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl}${options.uri}`;
+			returnData = await this.helpers.requestOAuth2.call(this, 'mauticOAuth2Api', options, {
+				includeCredentialsOnRefreshOnBody: true,
+			});
+		}
+
+		if (returnData.errors) {
+			// They seem to sometimes return 200 status but still error.
+			throw new NodeApiError(this.getNode(), returnData as JsonObject);
+		}
+
+		return returnData;
+	} catch (error) {
+		throw new NodeApiError(this.getNode(), error as JsonObject);
+	}
+}
+
+/**
+ * Make an API request to paginated mautic endpoint
+ * and return all results
+ */
+export async function mauticApiRequestAllItems(
+	this: IHookFunctions | IExecuteFunctions | ILoadOptionsFunctions,
+	propertyName: string,
+	method: IHttpRequestMethods,
+	endpoint: string,
+
+	body: any = {},
+	query: IDataObject = {},
+): Promise<any> {
+	const returnData: IDataObject[] = [];
+
+	let responseData;
+	query.limit = 30;
+	query.start = 0;
+
+	do {
+		responseData = await mauticApiRequest.call(this, method, endpoint, body, query);
+		const values = Object.values(responseData[propertyName] as IDataObject[]);
+		returnData.push.apply(returnData, values);
+		query.start += query.limit;
+	} while (
+		responseData.total !== undefined &&
+		returnData.length - parseInt(responseData.total as string, 10) < 0
+	);
+
+	return returnData;
+}
+
+export function validateJSON(json: string | undefined): any {
+	let result;
+	try {
+		result = JSON.parse(json!);
+	} catch (exception) {
+		result = undefined;
+	}
+	return result;
+}

packages/nodes-base/nodes/Mautic/Mautic.node.json

@@ -0,0 +1,30 @@
+{
+	"node": "n8n-nodes-base.mautic",
+	"nodeVersion": "1.0",
+	"codexVersion": "1.0",
+	"categories": ["Marketing", "Communication"],
+	"resources": {
+		"credentialDocumentation": [
+			{
+				"url": "https://docs.n8n.io/integrations/builtin/credentials/mautic/"
+			}
+		],
+		"primaryDocumentation": [
+			{
+				"url": "https://docs.n8n.io/integrations/builtin/app-nodes/n8n-nodes-base.mautic/"
+			}
+		],
+		"generic": [
+			{
+				"label": "How a digital strategist uses n8n for online marketing",
+				"icon": "💻",
+				"url": "https://n8n.io/blog/how-a-digital-strategist-uses-n8n-for-online-marketing/"
+			},
+			{
+				"label": "How a Membership Development Manager automates his work and investments",
+				"icon": "📈",
+				"url": "https://n8n.io/blog/how-a-membership-development-manager-automates-his-work-and-investments/"
+			}
+		]
+	}
+}

packages/nodes-base/nodes/Mautic/MauticTrigger.node.json

@@ -0,0 +1,25 @@
+{
+	"node": "n8n-nodes-base.mauticTrigger",
+	"nodeVersion": "1.0",
+	"codexVersion": "1.0",
+	"categories": ["Marketing", "Communication"],
+	"resources": {
+		"credentialDocumentation": [
+			{
+				"url": "https://docs.n8n.io/integrations/builtin/credentials/mautic/"
+			}
+		],
+		"primaryDocumentation": [
+			{
+				"url": "https://docs.n8n.io/integrations/builtin/trigger-nodes/n8n-nodes-base.mautictrigger/"
+			}
+		],
+		"generic": [
+			{
+				"label": "How a Membership Development Manager automates his work and investments",
+				"icon": "📈",
+				"url": "https://n8n.io/blog/how-a-membership-development-manager-automates-his-work-and-investments/"
+			}
+		]
+	}
+}

packages/nodes-base/nodes/Mautic/MauticTrigger.node.ts

@@ -0,0 +1,180 @@
+import {
+	type IHookFunctions,
+	type IWebhookFunctions,
+	type IDataObject,
+	type ILoadOptionsFunctions,
+	type INodePropertyOptions,
+	type INodeType,
+	type INodeTypeDescription,
+	type IWebhookResponseData,
+	NodeConnectionTypes,
+} from 'n8n-workflow';
+import { parse as urlParse } from 'url';
+
+import { mauticApiRequest } from './GenericFunctions';
+
+export class MauticTrigger implements INodeType {
+	description: INodeTypeDescription = {
+		displayName: 'Mautic Trigger',
+		name: 'mauticTrigger',
+		icon: 'file:mautic.svg',
+		group: ['trigger'],
+		version: 1,
+		description: 'Handle Mautic events via webhooks',
+		defaults: {
+			name: 'Mautic Trigger',
+		},
+		inputs: [],
+		outputs: [NodeConnectionTypes.Main],
+		credentials: [
+			{
+				name: 'mauticApi',
+				required: true,
+				displayOptions: {
+					show: {
+						authentication: ['credentials'],
+					},
+				},
+			},
+			{
+				name: 'mauticOAuth2Api',
+				required: true,
+				displayOptions: {
+					show: {
+						authentication: ['oAuth2'],
+					},
+				},
+			},
+		],
+		webhooks: [
+			{
+				name: 'default',
+				httpMethod: 'POST',
+				responseMode: 'onReceived',
+				path: 'webhook',
+			},
+		],
+		properties: [
+			{
+				displayName: 'Authentication',
+				name: 'authentication',
+				type: 'options',
+				options: [
+					{
+						name: 'Credentials',
+						value: 'credentials',
+					},
+					{
+						name: 'OAuth2',
+						value: 'oAuth2',
+					},
+				],
+				default: 'credentials',
+			},
+			{
+				displayName: 'Event Names or IDs',
+				name: 'events',
+				type: 'multiOptions',
+				description:
+					'Choose from the list, or specify IDs using an <a href="https://docs.n8n.io/code/expressions/">expression</a>',
+				required: true,
+				typeOptions: {
+					loadOptionsMethod: 'getEvents',
+				},
+				default: [],
+			},
+			{
+				displayName: 'Events Order',
+				name: 'eventsOrder',
+				type: 'options',
+				default: 'ASC',
+				options: [
+					{
+						name: 'ASC',
+						value: 'ASC',
+					},
+					{
+						name: 'DESC',
+						value: 'DESC',
+					},
+				],
+				description: 'Order direction for queued events in one webhook. Can be “DESC” or “ASC”.',
+			},
+		],
+	};
+
+	methods = {
+		loadOptions: {
+			// Get all the events to display them to user so that they can
+			// select them easily
+			async getEvents(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
+				const returnData: INodePropertyOptions[] = [];
+				const { triggers } = await mauticApiRequest.call(this, 'GET', '/hooks/triggers');
+				for (const [key, value] of Object.entries(triggers as IDataObject)) {
+					const eventId = key;
+					const eventName = (value as IDataObject).label as string;
+					const eventDecription = (value as IDataObject).description as string;
+					returnData.push({
+						name: eventName,
+						value: eventId,
+						description: eventDecription,
+					});
+				}
+				return returnData;
+			},
+		},
+	};
+
+	webhookMethods = {
+		default: {
+			async checkExists(this: IHookFunctions): Promise<boolean> {
+				const webhookData = this.getWorkflowStaticData('node');
+				if (webhookData.webhookId === undefined) {
+					return false;
+				}
+				const endpoint = `/hooks/${webhookData.webhookId}`;
+				try {
+					await mauticApiRequest.call(this, 'GET', endpoint, {});
+				} catch (error) {
+					return false;
+				}
+				return true;
+			},
+			async create(this: IHookFunctions): Promise<boolean> {
+				const webhookUrl = this.getNodeWebhookUrl('default') as string;
+				const webhookData = this.getWorkflowStaticData('node');
+				const events = this.getNodeParameter('events', 0) as string[];
+				const eventsOrder = this.getNodeParameter('eventsOrder', 0) as string;
+				const urlParts = urlParse(webhookUrl);
+				const body: IDataObject = {
+					name: `n8n-webhook:${urlParts.path}`,
+					description: 'n8n webhook',
+					webhookUrl,
+					triggers: events,
+					eventsOrderbyDir: eventsOrder,
+					isPublished: true,
+				};
+				const { hook } = await mauticApiRequest.call(this, 'POST', '/hooks/new', body);
+				webhookData.webhookId = hook.id;
+				return true;
+			},
+			async delete(this: IHookFunctions): Promise<boolean> {
+				const webhookData = this.getWorkflowStaticData('node');
+				try {
+					await mauticApiRequest.call(this, 'DELETE', `/hooks/${webhookData.webhookId}/delete`);
+				} catch (error) {
+					return false;
+				}
+				delete webhookData.webhookId;
+				return true;
+			},
+		},
+	};
+
+	async webhook(this: IWebhookFunctions): Promise<IWebhookResponseData> {
+		const req = this.getRequestObject();
+		return {
+			workflowData: [this.helpers.returnJsonArray(req.body as IDataObject)],
+		};
+	}
+}

packages/nodes-base/nodes/Mautic/SegmentEmailDescription.ts

@@ -0,0 +1,47 @@
+import type { INodeProperties } from 'n8n-workflow';
+
+export const segmentEmailOperations: INodeProperties[] = [
+	{
+		displayName: 'Operation',
+		name: 'operation',
+		type: 'options',
+		noDataExpression: true,
+		displayOptions: {
+			show: {
+				resource: ['segmentEmail'],
+			},
+		},
+		options: [
+			{
+				name: 'Send',
+				value: 'send',
+				action: 'Send an email to a segment',
+			},
+		],
+		default: 'send',
+	},
+];
+
+export const segmentEmailFields: INodeProperties[] = [
+	/* -------------------------------------------------------------------------- */
+	/*                               segmentEmail:send                            */
+	/* -------------------------------------------------------------------------- */
+	{
+		displayName: 'Segment Email Name or ID',
+		name: 'segmentEmailId',
+		type: 'options',
+		description:
+			'Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>',
+		required: true,
+		displayOptions: {
+			show: {
+				resource: ['segmentEmail'],
+				operation: ['send'],
+			},
+		},
+		typeOptions: {
+			loadOptionsMethod: 'getSegmentEmails',
+		},
+		default: '',
+	},
+];

packages/nodes-base/nodes/Mautic/mautic.svg

@@ -0,0 +1 @@
+<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>