n8n-nodes-twenty-pro 0.1.0

package/README.md

@@ -0,0 +1,78 @@
+# n8n-nodes-twenty-pro
+
+Comprehensive n8n community node for [Twenty CRM](https://twenty.com) — open-source CRM.
+
+**13 action nodes + 13 trigger nodes** for complete Twenty CRM integration.
+
+## Features
+
+- **13 resource-specific nodes** — Person, Company, Opportunity, Note, Task, CalendarEvent, Message, Attachment, Workflow, View, Webhook, ApiKey, CustomObject
+- **13 webhook trigger nodes** — one per resource (record created/updated/deleted)
+- **Dynamic schema discovery** — custom objects/fields auto-detected
+- **Complex field types** — FullName, Links, Currency, Address, Emails, Phones
+- **Full CRUD** — Create, Get, Update, Delete, Get Many on every resource
+- **Auto-retry** — exponential backoff on rate limits and network errors
+- **Record locator** — search by name, paste URL, or enter ID
+
+## Installation
+
+In n8n, go to **Settings > Community Nodes > Install** and enter:
+
+```
+n8n-nodes-twenty-pro
+```
+
+## Configuration
+
+1. In Twenty CRM: **Settings > Developers > API Keys** > Create API Key
+2. In n8n: Add **Twenty Pro API** credential
+3. Enter: **API Key** (from step 1), **Domain** (your Twenty URL, e.g. `https://app.twenty.com`)
+
+**Important:** Do NOT include `/graphql` or `/rest` in the domain.
+
+## Nodes
+
+### Action Nodes
+
+| Node | Operations | Fields |
+|------|-----------|--------|
+| Twenty Person | Create, Get, Update, Delete, Get Many | First Name, Last Name, Email, Phone, Job Title, City, LinkedIn, X |
+| Twenty Company | Create, Get, Update, Delete, Get Many | Name, Domain, LinkedIn, X, Address (6 fields), Revenue, Employees |
+| Twenty Opportunity | Create, Get, Update, Delete, Get Many | Name, Amount, Stage, Close Date |
+| Twenty Note | Create, Get, Update, Delete, Get Many | Title, Content |
+| Twenty Task | Create, Get, Update, Delete, Get Many | Title, Due Date, Priority, Assignee ID |
+| Twenty Calendar Event | Create, Get, Update, Delete, Get Many | Title, Starts At, Ends At |
+| Twenty Message | Create, Get, Update, Delete, Get Many | Subject, Body |
+| Twenty Attachment | Create, Get, Update, Delete, Get Many | Name, MIME Type, Attachment URL |
+| Twenty Workflow | Create, Get, Update, Delete, Get Many | Name, Status, Trigger Type |
+| Twenty View | Create, Get, Update, Delete, Get Many | Name, Object Type |
+| Twenty Webhook | Create, Get, Update, Delete, Get Many | Target URL, Event Types |
+| Twenty API Key | Create, Get, Update, Delete, Get Many | Name, Expires At |
+| Twenty Custom Object | Create, Get, Update, Delete, Get Many | Dynamic (based on schema) |
+
+### Trigger Nodes
+
+Every resource has a corresponding trigger node: Twenty [Resource] Trigger.
+
+Events per trigger: Record Created / Record Updated / Record Deleted
+
+## API
+
+Uses **REST** for all data operations. **GraphQL** only for schema introspection (custom field discovery).
+
+- Requires Twenty CRM v1.4.0+
+- Requires n8n v1.0.0+
+- Node.js 18.10+
+
+## Development
+
+```bash
+git clone <repo>
+cd n8n-nodes-twenty-pro
+npm install
+npm run build
+```
+
+## License
+
+MIT

package/gulpfile.js

@@ -0,0 +1,38 @@
+const { src, dest, series } = require('gulp');
+const path = require('path');
+const fs = require('fs');
+
+// Copy SVG icon to every directory that contains a .node.js file
+function copySvg(done) {
+  const svgSrc = 'src/nodes/shared/twentyPro.svg';
+  if (!fs.existsSync(svgSrc)) {
+    console.warn('twentyPro.svg not found, skipping copy');
+    return done();
+  }
+  const distNodes = 'dist/nodes';
+  const entries = fs.readdirSync(distNodes, { withFileTypes: true });
+  const dirs = [];
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const sub = entry.name; // actions or triggers
+    const subPath = path.join(distNodes, sub);
+    for (const resource of fs.readdirSync(subPath)) {
+      const resourcePath = path.join(subPath, resource);
+      if (fs.statSync(resourcePath).isDirectory()) {
+        dirs.push(resourcePath);
+      }
+    }
+  }
+  for (const dir of dirs) {
+    fs.copyFileSync(svgSrc, path.join(dir, 'twentyPro.svg'));
+  }
+  console.log(`Copied twentyPro.svg to ${dirs.length} node directories`);
+  done();
+}
+
+function build() {
+  return src('dist/**/*.js')
+    .pipe(dest('dist/'));
+}
+
+exports.build = series(build, copySvg);

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "n8n-nodes-twenty-pro",
+  "version": "0.1.0",
+  "description": "Comprehensive n8n community node for Twenty CRM with 32 resource nodes + 32 trigger nodes",
+  "keywords": ["n8n", "n8n-community-node", "twenty", "twenty-crm", "crm"],
+  "license": "MIT",
+  "author": { "name": "Suheb", "email": "suheb@example.com" },
+  "engines": { "node": ">=18.10.0" },
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": ["dist/credentials/TwentyProApi.credentials.js"],
+    "nodes": [
+      "dist/nodes/actions/Person/TwentyProPerson.node.js",
+      "dist/nodes/actions/Company/TwentyProCompany.node.js",
+      "dist/nodes/actions/Opportunity/TwentyProOpportunity.node.js",
+      "dist/nodes/actions/Note/TwentyProNote.node.js",
+      "dist/nodes/actions/Task/TwentyProTask.node.js",
+      "dist/nodes/actions/CalendarEvent/TwentyProCalendarEvent.node.js",
+      "dist/nodes/actions/Message/TwentyProMessage.node.js",
+      "dist/nodes/actions/Attachment/TwentyProAttachment.node.js",
+      "dist/nodes/actions/Workflow/TwentyProWorkflow.node.js",
+      "dist/nodes/actions/View/TwentyProView.node.js",
+      "dist/nodes/actions/Webhook/TwentyProWebhook.node.js",
+      "dist/nodes/actions/ApiKey/TwentyProApiKey.node.js",
+      "dist/nodes/actions/CustomObject/TwentyProCustomObject.node.js",
+      "dist/nodes/triggers/Person/TwentyProPersonTrigger.node.js",
+      "dist/nodes/triggers/Company/TwentyProCompanyTrigger.node.js",
+      "dist/nodes/triggers/Opportunity/TwentyProOpportunityTrigger.node.js",
+      "dist/nodes/triggers/Note/TwentyProNoteTrigger.node.js",
+      "dist/nodes/triggers/Task/TwentyProTaskTrigger.node.js",
+      "dist/nodes/triggers/CalendarEvent/TwentyProCalendarEventTrigger.node.js",
+      "dist/nodes/triggers/Message/TwentyProMessageTrigger.node.js",
+      "dist/nodes/triggers/Attachment/TwentyProAttachmentTrigger.node.js",
+      "dist/nodes/triggers/Workflow/TwentyProWorkflowTrigger.node.js",
+      "dist/nodes/triggers/View/TwentyProViewTrigger.node.js",
+      "dist/nodes/triggers/Webhook/TwentyProWebhookTrigger.node.js",
+      "dist/nodes/triggers/ApiKey/TwentyProApiKeyTrigger.node.js",
+      "dist/nodes/triggers/CustomObject/TwentyProCustomObjectTrigger.node.js"
+    ]
+  },
+  "scripts": {
+    "build": "tsc && gulp build",
+    "dev": "tsc -w",
+    "lint": "tslint -p tsconfig.json -c tslint.json",
+    "lint:fix": "tslint --fix -p tsconfig.json -c tslint.json"
+  },
+  "peerDependencies": { "n8n-workflow": "*" },
+  "devDependencies": {
+    "@types/node": "^18.10.0",
+    "gulp": "^4.0.2",
+    "n8n-node-dev": "^2.9.1",
+    "tslint": "^6.1.3",
+    "typescript": "^5.0.0"
+  }
+}

package/src/credentials/TwentyProApi.credentials.ts

@@ -0,0 +1,27 @@
+import { ICredentialType, INodeProperties } from 'n8n-workflow';
+
+export class TwentyProApi implements ICredentialType {
+  name = 'twentyProApi';
+  displayName = 'Twenty Pro API';
+  documentationUrl = 'https://twenty.com/developers';
+  properties: INodeProperties[] = [
+    {
+      displayName: 'API Key',
+      name: 'apiKey',
+      type: 'string',
+      typeOptions: { password: true },
+      required: true,
+      default: '',
+      description: 'API key from Twenty CRM (Settings → Developers → API Keys)',
+    },
+    {
+      displayName: 'Domain',
+      name: 'domain',
+      type: 'string',
+      required: true,
+      default: '',
+      placeholder: 'https://app.twenty.com',
+      description: 'Your Twenty CRM instance URL. Do NOT include /graphql or /rest.',
+    },
+  ];
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+// n8n-nodes-twenty-pro - comprehensive Twenty CRM integration for n8n
+export * from './credentials/TwentyProApi.credentials';

package/src/nodes/actions/ApiKey/TwentyProApiKey.node.ts

@@ -0,0 +1,84 @@
+import { IDataObject, INodeType, INodeTypeDescription, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
+import * as create from './operations/create';
+import * as get from './operations/get';
+import * as update from './operations/update';
+import * as del from './operations/delete';
+import * as getMany from './operations/getMany';
+
+export class TwentyProApiKey implements INodeType {
+  description: INodeTypeDescription = {
+    displayName: 'Twenty API Key',
+    name: 'twentyProApiKey',
+    icon: 'file:twentyPro.svg',
+    group: ['transform'],
+    version: 1,
+    subtitle: '={{$parameter["operation"]}}',
+    description: 'Manage API keys in Twenty CRM',
+    defaults: { name: 'Twenty API Key' },
+    inputs: ['main'],
+    outputs: ['main'],
+    credentials: [{ name: 'twentyProApi', required: true }],
+    properties: [
+      {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        required: true,
+        default: 'create',
+        options: [
+          { name: 'Create', value: 'create', description: 'Create a new API key' },
+          { name: 'Get', value: 'get', description: 'Get an API key by ID' },
+          { name: 'Update', value: 'update', description: 'Update an API key' },
+          { name: 'Delete', value: 'delete', description: 'Delete an API key' },
+          { name: 'Get Many', value: 'getMany', description: 'List API keys' },
+        ],
+      },
+      {
+        displayName: 'Record ID',
+        name: 'recordId',
+        type: 'string',
+        default: '',
+        required: true,
+        displayOptions: { show: { operation: ['get', 'update', 'delete'] } },
+        placeholder: 'abc-123-def-456',
+      },
+      {
+        displayName: 'Fields',
+        name: 'fields',
+        placeholder: 'Add Field',
+        type: 'fixedCollection',
+        default: {},
+        typeOptions: { multipleValues: true },
+        displayOptions: { show: { operation: ['create', 'update'] } },
+        options: [
+          {
+            name: 'fieldValues',
+            displayName: 'Field',
+            values: [
+              { displayName: 'Name', name: 'name', type: 'string', default: '' },
+              { displayName: 'Expires At', name: 'expiresAt', type: 'string', default: '' },
+            ],
+          },
+        ],
+      },
+      { displayName: 'Return All', name: 'returnAll', type: 'boolean', default: false, displayOptions: { show: { operation: ['getMany'] } } },
+      { displayName: 'Limit', name: 'limit', type: 'number', default: 50, displayOptions: { show: { operation: ['getMany'], returnAll: [false] } }, typeOptions: { minValue: 1, maxValue: 100 } },
+    ],
+  };
+
+  async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
+    const items = this.getInputData();
+    const operation = this.getNode().parameters.operation as string;
+    let result: INodeExecutionData[];
+    switch (operation) {
+      case 'create': result = await create.execute.call(this, items); break;
+      case 'get': result = await get.execute.call(this, items); break;
+      case 'update': result = await update.execute.call(this, items); break;
+      case 'delete': result = await del.execute.call(this, items); break;
+      case 'getMany': result = await getMany.execute.call(this, items); break;
+      default: throw new Error(`Unknown operation: ${operation}`);
+    }
+    return [result];
+  }
+}

package/src/nodes/actions/ApiKey/operations/create.ts

@@ -0,0 +1,14 @@
+import { IDataObject, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
+import { apiRequest } from '../../../shared/TwentyProApi.client';
+import { transformApiKeyFields } from '../../../shared/FieldTransformers';
+
+export async function execute(this: IExecuteFunctions, items: INodeExecutionData[]): Promise<INodeExecutionData[]> {
+  const returnData: INodeExecutionData[] = [];
+  for (let i = 0; i < items.length; i++) {
+    const fields = this.getNode().parameters.fields as Record<string, unknown> || {};
+    const transformed = transformApiKeyFields(fields);
+    const response = await apiRequest.call(this, 'POST', '/apiKeys', transformed);
+    returnData.push({ json: response as IDataObject });
+  }
+  return returnData;
+}

package/src/nodes/actions/ApiKey/operations/delete.ts

@@ -0,0 +1,12 @@
+import { IDataObject, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
+import { apiRequest } from '../../../shared/TwentyProApi.client';
+
+export async function execute(this: IExecuteFunctions, items: INodeExecutionData[]): Promise<INodeExecutionData[]> {
+  const returnData: INodeExecutionData[] = [];
+  for (let i = 0; i < items.length; i++) {
+    const id = this.getNode().parameters.recordId as string;
+    await apiRequest.call(this, 'DELETE', `/apiKeys/${id}`);
+    returnData.push({ json: { success: true, id } as IDataObject });
+  }
+  return returnData;
+}

package/src/nodes/actions/ApiKey/operations/get.ts

@@ -0,0 +1,12 @@
+import { IDataObject, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
+import { apiRequest } from '../../../shared/TwentyProApi.client';
+
+export async function execute(this: IExecuteFunctions, items: INodeExecutionData[]): Promise<INodeExecutionData[]> {
+  const returnData: INodeExecutionData[] = [];
+  for (let i = 0; i < items.length; i++) {
+    const id = this.getNode().parameters.recordId as string;
+    const response = await apiRequest.call(this, 'GET', `/apiKeys/${id}`);
+    returnData.push({ json: response as IDataObject });
+  }
+  return returnData;
+}

package/src/nodes/actions/ApiKey/operations/getMany.ts

@@ -0,0 +1,14 @@
+import { IDataObject, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
+import { apiRequest } from '../../../shared/TwentyProApi.client';
+
+export async function execute(this: IExecuteFunctions, items: INodeExecutionData[]): Promise<INodeExecutionData[]> {
+  const returnAll = this.getNode().parameters.returnAll as boolean;
+  const limit = this.getNode().parameters.limit as number;
+  const qs: Record<string, string> = {};
+  if (!returnAll) { qs.limit = String(limit); }
+  const response = await apiRequest.call(this, 'GET', '/apiKeys', undefined, qs) as IDataObject;
+  const data = response.data as IDataObject | undefined;
+  const dataKeys = data ? Object.keys(data) : [];
+  const items_arr = dataKeys.length > 0 ? ((data![dataKeys[0]] as IDataObject[]) ?? []) : [];
+  return items_arr.map((item) => ({ json: item }));
+}

package/src/nodes/actions/ApiKey/operations/update.ts

@@ -0,0 +1,15 @@
+import { IDataObject, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
+import { apiRequest } from '../../../shared/TwentyProApi.client';
+import { transformApiKeyFields } from '../../../shared/FieldTransformers';
+
+export async function execute(this: IExecuteFunctions, items: INodeExecutionData[]): Promise<INodeExecutionData[]> {
+  const returnData: INodeExecutionData[] = [];
+  for (let i = 0; i < items.length; i++) {
+    const id = this.getNode().parameters.recordId as string;
+    const fields = this.getNode().parameters.fields as Record<string, unknown> || {};
+    const transformed = transformApiKeyFields(fields);
+    const response = await apiRequest.call(this, 'PATCH', `/apiKeys/${id}`, transformed);
+    returnData.push({ json: response as IDataObject });
+  }
+  return returnData;
+}

package/src/nodes/actions/Attachment/TwentyProAttachment.node.ts

@@ -0,0 +1,85 @@
+import { IDataObject, INodeType, INodeTypeDescription, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
+import * as create from './operations/create';
+import * as get from './operations/get';
+import * as update from './operations/update';
+import * as del from './operations/delete';
+import * as getMany from './operations/getMany';
+
+export class TwentyProAttachment implements INodeType {
+  description: INodeTypeDescription = {
+    displayName: 'Twenty Attachment',
+    name: 'twentyProAttachment',
+    icon: 'file:twentyPro.svg',
+    group: ['transform'],
+    version: 1,
+    subtitle: '={{$parameter["operation"]}}',
+    description: 'Manage attachments in Twenty CRM',
+    defaults: { name: 'Twenty Attachment' },
+    inputs: ['main'],
+    outputs: ['main'],
+    credentials: [{ name: 'twentyProApi', required: true }],
+    properties: [
+      {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        required: true,
+        default: 'create',
+        options: [
+          { name: 'Create', value: 'create', description: 'Create a new attachment' },
+          { name: 'Get', value: 'get', description: 'Get an attachment by ID' },
+          { name: 'Update', value: 'update', description: 'Update an attachment' },
+          { name: 'Delete', value: 'delete', description: 'Delete an attachment' },
+          { name: 'Get Many', value: 'getMany', description: 'List attachments' },
+        ],
+      },
+      {
+        displayName: 'Record ID',
+        name: 'recordId',
+        type: 'string',
+        default: '',
+        required: true,
+        displayOptions: { show: { operation: ['get', 'update', 'delete'] } },
+        placeholder: 'abc-123-def-456',
+      },
+      {
+        displayName: 'Fields',
+        name: 'fields',
+        placeholder: 'Add Field',
+        type: 'fixedCollection',
+        default: {},
+        typeOptions: { multipleValues: true },
+        displayOptions: { show: { operation: ['create', 'update'] } },
+        options: [
+          {
+            name: 'fieldValues',
+            displayName: 'Field',
+            values: [
+              { displayName: 'Name', name: 'name', type: 'string', default: '' },
+              { displayName: 'Mime Type', name: 'mimeType', type: 'string', default: '' },
+              { displayName: 'Attachment Url', name: 'attachmentUrl', type: 'string', default: '' },
+            ],
+          },
+        ],
+      },
+      { displayName: 'Return All', name: 'returnAll', type: 'boolean', default: false, displayOptions: { show: { operation: ['getMany'] } } },
+      { displayName: 'Limit', name: 'limit', type: 'number', default: 50, displayOptions: { show: { operation: ['getMany'], returnAll: [false] } }, typeOptions: { minValue: 1, maxValue: 100 } },
+    ],
+  };
+
+  async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
+    const items = this.getInputData();
+    const operation = this.getNode().parameters.operation as string;
+    let result: INodeExecutionData[];
+    switch (operation) {
+      case 'create': result = await create.execute.call(this, items); break;
+      case 'get': result = await get.execute.call(this, items); break;
+      case 'update': result = await update.execute.call(this, items); break;
+      case 'delete': result = await del.execute.call(this, items); break;
+      case 'getMany': result = await getMany.execute.call(this, items); break;
+      default: throw new Error(`Unknown operation: ${operation}`);
+    }
+    return [result];
+  }
+}

package/src/nodes/actions/Attachment/operations/create.ts

@@ -0,0 +1,14 @@
+import { IDataObject, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
+import { apiRequest } from '../../../shared/TwentyProApi.client';
+import { transformAttachmentFields } from '../../../shared/FieldTransformers';
+
+export async function execute(this: IExecuteFunctions, items: INodeExecutionData[]): Promise<INodeExecutionData[]> {
+  const returnData: INodeExecutionData[] = [];
+  for (let i = 0; i < items.length; i++) {
+    const fields = this.getNode().parameters.fields as Record<string, unknown> || {};
+    const transformed = transformAttachmentFields(fields);
+    const response = await apiRequest.call(this, 'POST', '/attachments', transformed);
+    returnData.push({ json: response as IDataObject });
+  }
+  return returnData;
+}

package/src/nodes/actions/Attachment/operations/delete.ts

@@ -0,0 +1,12 @@
+import { IDataObject, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
+import { apiRequest } from '../../../shared/TwentyProApi.client';
+
+export async function execute(this: IExecuteFunctions, items: INodeExecutionData[]): Promise<INodeExecutionData[]> {
+  const returnData: INodeExecutionData[] = [];
+  for (let i = 0; i < items.length; i++) {
+    const id = this.getNode().parameters.recordId as string;
+    await apiRequest.call(this, 'DELETE', `/attachments/${id}`);
+    returnData.push({ json: { success: true, id } as IDataObject });
+  }
+  return returnData;
+}

package/src/nodes/actions/Attachment/operations/get.ts

@@ -0,0 +1,12 @@
+import { IDataObject, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
+import { apiRequest } from '../../../shared/TwentyProApi.client';
+
+export async function execute(this: IExecuteFunctions, items: INodeExecutionData[]): Promise<INodeExecutionData[]> {
+  const returnData: INodeExecutionData[] = [];
+  for (let i = 0; i < items.length; i++) {
+    const id = this.getNode().parameters.recordId as string;
+    const response = await apiRequest.call(this, 'GET', `/attachments/${id}`);
+    returnData.push({ json: response as IDataObject });
+  }
+  return returnData;
+}

package/src/nodes/actions/Attachment/operations/getMany.ts

@@ -0,0 +1,14 @@
+import { IDataObject, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
+import { apiRequest } from '../../../shared/TwentyProApi.client';
+
+export async function execute(this: IExecuteFunctions, items: INodeExecutionData[]): Promise<INodeExecutionData[]> {
+  const returnAll = this.getNode().parameters.returnAll as boolean;
+  const limit = this.getNode().parameters.limit as number;
+  const qs: Record<string, string> = {};
+  if (!returnAll) { qs.limit = String(limit); }
+  const response = await apiRequest.call(this, 'GET', '/attachments', undefined, qs) as IDataObject;
+  const data = response.data as IDataObject | undefined;
+  const dataKeys = data ? Object.keys(data) : [];
+  const items_arr = dataKeys.length > 0 ? ((data![dataKeys[0]] as IDataObject[]) ?? []) : [];
+  return items_arr.map((item) => ({ json: item }));
+}

package/src/nodes/actions/Attachment/operations/update.ts

@@ -0,0 +1,15 @@
+import { IDataObject, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
+import { apiRequest } from '../../../shared/TwentyProApi.client';
+import { transformAttachmentFields } from '../../../shared/FieldTransformers';
+
+export async function execute(this: IExecuteFunctions, items: INodeExecutionData[]): Promise<INodeExecutionData[]> {
+  const returnData: INodeExecutionData[] = [];
+  for (let i = 0; i < items.length; i++) {
+    const id = this.getNode().parameters.recordId as string;
+    const fields = this.getNode().parameters.fields as Record<string, unknown> || {};
+    const transformed = transformAttachmentFields(fields);
+    const response = await apiRequest.call(this, 'PATCH', `/attachments/${id}`, transformed);
+    returnData.push({ json: response as IDataObject });
+  }
+  return returnData;
+}

package/src/nodes/actions/CalendarEvent/TwentyProCalendarEvent.node.ts

@@ -0,0 +1,85 @@
+import { IDataObject, INodeType, INodeTypeDescription, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
+import * as create from './operations/create';
+import * as get from './operations/get';
+import * as update from './operations/update';
+import * as del from './operations/delete';
+import * as getMany from './operations/getMany';
+
+export class TwentyProCalendarEvent implements INodeType {
+  description: INodeTypeDescription = {
+    displayName: 'Twenty Calendar Event',
+    name: 'twentyProCalendarEvent',
+    icon: 'file:twentyPro.svg',
+    group: ['transform'],
+    version: 1,
+    subtitle: '={{$parameter["operation"]}}',
+    description: 'Manage calendar events in Twenty CRM',
+    defaults: { name: 'Twenty Calendar Event' },
+    inputs: ['main'],
+    outputs: ['main'],
+    credentials: [{ name: 'twentyProApi', required: true }],
+    properties: [
+      {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        required: true,
+        default: 'create',
+        options: [
+          { name: 'Create', value: 'create', description: 'Create a new calendar event' },
+          { name: 'Get', value: 'get', description: 'Get a calendar event by ID' },
+          { name: 'Update', value: 'update', description: 'Update a calendar event' },
+          { name: 'Delete', value: 'delete', description: 'Delete a calendar event' },
+          { name: 'Get Many', value: 'getMany', description: 'List calendar events' },
+        ],
+      },
+      {
+        displayName: 'Record ID',
+        name: 'recordId',
+        type: 'string',
+        default: '',
+        required: true,
+        displayOptions: { show: { operation: ['get', 'update', 'delete'] } },
+        placeholder: 'abc-123-def-456',
+      },
+      {
+        displayName: 'Fields',
+        name: 'fields',
+        placeholder: 'Add Field',
+        type: 'fixedCollection',
+        default: {},
+        typeOptions: { multipleValues: true },
+        displayOptions: { show: { operation: ['create', 'update'] } },
+        options: [
+          {
+            name: 'fieldValues',
+            displayName: 'Field',
+            values: [
+              { displayName: 'Title', name: 'title', type: 'string', default: '' },
+              { displayName: 'Starts At', name: 'startsAt', type: 'string', default: '' },
+              { displayName: 'Ends At', name: 'endsAt', type: 'string', default: '' },
+            ],
+          },
+        ],
+      },
+      { displayName: 'Return All', name: 'returnAll', type: 'boolean', default: false, displayOptions: { show: { operation: ['getMany'] } } },
+      { displayName: 'Limit', name: 'limit', type: 'number', default: 50, displayOptions: { show: { operation: ['getMany'], returnAll: [false] } }, typeOptions: { minValue: 1, maxValue: 100 } },
+    ],
+  };
+
+  async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
+    const items = this.getInputData();
+    const operation = this.getNode().parameters.operation as string;
+    let result: INodeExecutionData[];
+    switch (operation) {
+      case 'create': result = await create.execute.call(this, items); break;
+      case 'get': result = await get.execute.call(this, items); break;
+      case 'update': result = await update.execute.call(this, items); break;
+      case 'delete': result = await del.execute.call(this, items); break;
+      case 'getMany': result = await getMany.execute.call(this, items); break;
+      default: throw new Error(`Unknown operation: ${operation}`);
+    }
+    return [result];
+  }
+}

package/src/nodes/actions/CalendarEvent/operations/create.ts

@@ -0,0 +1,14 @@
+import { IDataObject, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
+import { apiRequest } from '../../../shared/TwentyProApi.client';
+import { transformCalendarEventFields } from '../../../shared/FieldTransformers';
+
+export async function execute(this: IExecuteFunctions, items: INodeExecutionData[]): Promise<INodeExecutionData[]> {
+  const returnData: INodeExecutionData[] = [];
+  for (let i = 0; i < items.length; i++) {
+    const fields = this.getNode().parameters.fields as Record<string, unknown> || {};
+    const transformed = transformCalendarEventFields(fields);
+    const response = await apiRequest.call(this, 'POST', '/calendarEvents', transformed);
+    returnData.push({ json: response as IDataObject });
+  }
+  return returnData;
+}

package/src/nodes/actions/CalendarEvent/operations/delete.ts

@@ -0,0 +1,12 @@
+import { IDataObject, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
+import { apiRequest } from '../../../shared/TwentyProApi.client';
+
+export async function execute(this: IExecuteFunctions, items: INodeExecutionData[]): Promise<INodeExecutionData[]> {
+  const returnData: INodeExecutionData[] = [];
+  for (let i = 0; i < items.length; i++) {
+    const id = this.getNode().parameters.recordId as string;
+    await apiRequest.call(this, 'DELETE', `/calendarEvents/${id}`);
+    returnData.push({ json: { success: true, id } as IDataObject });
+  }
+  return returnData;
+}

package/src/nodes/actions/CalendarEvent/operations/get.ts

@@ -0,0 +1,12 @@
+import { IDataObject, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
+import { apiRequest } from '../../../shared/TwentyProApi.client';
+
+export async function execute(this: IExecuteFunctions, items: INodeExecutionData[]): Promise<INodeExecutionData[]> {
+  const returnData: INodeExecutionData[] = [];
+  for (let i = 0; i < items.length; i++) {
+    const id = this.getNode().parameters.recordId as string;
+    const response = await apiRequest.call(this, 'GET', `/calendarEvents/${id}`);
+    returnData.push({ json: response as IDataObject });
+  }
+  return returnData;
+}