@pvass24/n8n-nodes-twenty-crm 1.0.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Patrick Vassell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,297 @@
+# n8n-nodes-twenty-crm
+
+[![npm version](https://img.shields.io/npm/v/n8n-nodes-twenty-crm.svg)](https://www.npmjs.com/package/n8n-nodes-twenty-crm)
+[![npm downloads](https://img.shields.io/npm/dm/n8n-nodes-twenty-crm.svg)](https://www.npmjs.com/package/n8n-nodes-twenty-crm)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![n8n community node](https://img.shields.io/badge/n8n-community%20node-ff6d5a)](https://docs.n8n.io/integrations/community-nodes/)
+
+> The production-grade n8n community node for [Twenty CRM](https://twenty.com) — the open-source alternative to Salesforce.
+
+Full CRUD operations with **cursor pagination**, **advanced filtering**, **composite field handling**, and **zero runtime dependencies**.
+
+---
+
+## Why This Node?
+
+| Feature | n8n-nodes-twenty-crm | Other Twenty nodes |
+|---------|---------------------|-------------------|
+| Pagination (Return All) | **Full cursor-based** | None (max 60 results) |
+| Filtering | **Built-in filter UI** | Manual query strings |
+| Create/Update bodies | **Properly structured** | Broken (bugs #5, #6) |
+| Error messages | **Actionable & clear** | Raw JSON dumps |
+| Runtime dependencies | **Zero** | Has runtime deps |
+| n8n verification eligible | **Yes** | No |
+| AI Agent compatible | **Yes** (`usableAsTool`) | No |
+| Custom field support | **Via Additional Fields** | Not supported |
+| Test coverage | **24 tests (unit + integration)** | None |
+
+---
+
+## Installation
+
+### In n8n (Recommended)
+
+1. Go to **Settings** → **Community Nodes**
+2. Select **Install a community node**
+3. Enter: `n8n-nodes-twenty-crm`
+4. Click **Install**
+
+### Via npm (Self-hosted)
+
+```bash
+cd ~/.n8n/custom
+npm install n8n-nodes-twenty-crm
+```
+
+Then restart n8n.
+
+---
+
+## Setup
+
+1. In your Twenty CRM instance, go to **Settings** → **Playground**
+2. Generate an API key
+3. In n8n, create new credentials:
+   - **Credential Type**: Twenty CRM API
+   - **Server URL**: Your Twenty instance URL (e.g. `https://crm.yourdomain.com`)
+   - **API Key**: Paste the key from step 2
+
+The credential test will automatically verify connectivity.
+
+---
+
+## Resources & Operations
+
+### Company
+
+| Operation | Description |
+|-----------|-------------|
+| **Create** | Create a company with name, domain, address, LinkedIn, revenue |
+| **Get** | Retrieve a company by ID |
+| **Get Many** | List companies with filters, ordering, and pagination |
+| **Update** | Update any company field |
+| **Delete** | Soft-delete a company |
+
+### Person (Contact)
+
+| Operation | Description |
+|-----------|-------------|
+| **Create** | Create a contact with name, email, phone, job title, company link |
+| **Get** | Retrieve a person by ID |
+| **Get Many** | List people with filters on name, email, company |
+| **Update** | Update any person field |
+| **Delete** | Soft-delete a person |
+
+### Opportunity (Deal)
+
+| Operation | Description |
+|-----------|-------------|
+| **Create** | Create a deal with stage, amount, close date, company/contact links |
+| **Get** | Retrieve an opportunity by ID |
+| **Get Many** | List opportunities filtered by stage, company, date |
+| **Update** | Update stage, amount, or any field |
+| **Delete** | Soft-delete an opportunity |
+
+### Note
+
+| Operation | Description |
+|-----------|-------------|
+| **Create** | Create a note with title and body |
+| **Get** | Retrieve a note by ID |
+| **Get Many** | List all notes with pagination |
+| **Update** | Update title or body |
+| **Delete** | Soft-delete a note |
+
+### Task
+
+| Operation | Description |
+|-----------|-------------|
+| **Create** | Create a task with title, body, due date, status, assignee |
+| **Get** | Retrieve a task by ID |
+| **Get Many** | List tasks filtered by status |
+| **Update** | Update status, assignee, due date, or any field |
+| **Delete** | Soft-delete a task |
+
+---
+
+## Usage Examples
+
+### Create a Company
+
+```json
+{
+  "resource": "company",
+  "operation": "create",
+  "name": "Acme Corp",
+  "additionalFields": {
+    "domainUrl": "https://acme.com",
+    "addressCity": "San Francisco",
+    "addressState": "CA",
+    "addressCountry": "US",
+    "annualRevenueMicros": 5000000000,
+    "currencyCode": "USD"
+  }
+}
+```
+
+### List People by Company
+
+```json
+{
+  "resource": "person",
+  "operation": "getAll",
+  "returnAll": false,
+  "limit": 20,
+  "filters": {
+    "companyId": "your-company-uuid"
+  }
+}
+```
+
+### Update Opportunity Stage
+
+```json
+{
+  "resource": "opportunity",
+  "operation": "update",
+  "opportunityId": "your-opportunity-uuid",
+  "updateFields": {
+    "stage": "CLOSED_WON",
+    "amountMicros": 25000000000,
+    "currencyCode": "USD"
+  }
+}
+```
+
+### Search Companies by Name
+
+```json
+{
+  "resource": "company",
+  "operation": "getAll",
+  "returnAll": false,
+  "limit": 10,
+  "filters": {
+    "nameContains": "tech"
+  },
+  "orderBy": "createdAt[DescNullsLast]"
+}
+```
+
+---
+
+## Filtering
+
+The node provides a user-friendly filter UI that translates to Twenty's powerful filter syntax:
+
+| Filter Type | Example | Twenty Syntax |
+|-------------|---------|---------------|
+| Substring match | Name Contains: "tech" | `name[ilike]:"%tech%"` |
+| Date range | Created After: 2024-01-01 | `createdAt[gte]:"2024-01-01"` |
+| Exact match | Company ID: uuid | `companyId[eq]:"uuid"` |
+| Stage filter | Stage: CLOSED_WON | `stage[eq]:"CLOSED_WON"` |
+
+All filters are combined with AND logic. For advanced queries, use the Twenty API directly.
+
+---
+
+## Pagination
+
+- **Return All = false**: Returns up to `limit` results (max 60 per page)
+- **Return All = true**: Automatically paginates through all results using cursor-based pagination
+
+The node handles cursor tokens internally — you never need to manage `starting_after` or `endCursor` manually.
+
+---
+
+## AI Agent Support
+
+This node has `usableAsTool: true`, making it available as a tool in n8n's AI Agent workflows. An LLM can:
+
+- Search for companies or contacts
+- Create tasks and notes
+- Update opportunity stages
+- Query pipeline data
+
+---
+
+## Compatibility
+
+| Requirement | Version |
+|-------------|---------|
+| n8n | >= 1.0.0 |
+| Node.js | >= 18 |
+| Twenty CRM | >= 0.30 (REST API v1) |
+
+Works with both [Twenty Cloud](https://twenty.com) and self-hosted instances.
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/pvass24/n8n-nodes-twenty-crm.git
+cd n8n-nodes-twenty-crm
+npm install
+npm run build
+
+# Run unit tests
+npm test
+
+# Run integration tests (requires .env.test with API credentials)
+npm run test:integration
+```
+
+### Testing Setup
+
+Create `.env.test` in the project root:
+
+```env
+TWENTY_API_URL=https://your-twenty-instance.com/rest
+TWENTY_API_KEY=your-api-key-here
+```
+
+---
+
+## Contributing
+
+Contributions are welcome! Please:
+
+1. Fork this repository
+2. Create a feature branch (`git checkout -b feat/new-resource`)
+3. Write tests for your changes
+4. Ensure `npm test` and `npm run build` pass
+5. Submit a Pull Request
+
+### Adding a New Resource
+
+1. Create `nodes/TwentyCrm/resources/{resource}/{resource}.description.ts`
+2. Create `nodes/TwentyCrm/resources/{resource}/{resource}.handler.ts`
+3. Import and register in `TwentyCrm.node.ts`
+4. Add integration tests
+
+---
+
+## Roadmap
+
+- [ ] Polling Trigger node (new companies, updated deals, etc.)
+- [ ] Webhook Trigger (when Twenty adds webhook support)
+- [ ] Custom Objects support
+- [ ] Custom Fields dynamic loading
+- [ ] Batch operations (create/update many)
+- [ ] File attachments
+
+---
+
+## License
+
+[MIT](LICENSE.md) — built by [Patrick Vassell](https://iampjv.co)
+
+---
+
+## Links
+
+- [Twenty CRM](https://twenty.com) — The open-source CRM
+- [Twenty REST API Docs](https://twenty.com/developers/rest-api)
+- [n8n Community Nodes](https://docs.n8n.io/integrations/community-nodes/)
+- [Report Issues](https://github.com/pvass24/n8n-nodes-twenty-crm/issues)

package/dist/credentials/TwentyCrmApi.credentials.d.ts

@@ -0,0 +1,10 @@
+import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties, Icon } from 'n8n-workflow';
+export declare class TwentyCrmApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    icon: Icon;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/TwentyCrmApi.credentials.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TwentyCrmApi = void 0;
+class TwentyCrmApi {
+    constructor() {
+        this.name = 'twentyCrmApi';
+        this.displayName = 'Twenty CRM API';
+        this.icon = 'file:../icons/twenty.svg';
+        this.documentationUrl = 'https://twenty.com/developers/rest-api';
+        this.properties = [
+            {
+                displayName: 'Server URL',
+                name: 'serverUrl',
+                type: 'string',
+                default: 'https://api.twenty.com',
+                placeholder: 'https://crm.yourdomain.com',
+                description: 'The base URL of your Twenty CRM instance (no trailing slash)',
+            },
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                description: 'Generate in Settings → Playground in your Twenty workspace',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.apiKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.serverUrl}}',
+                url: '/rest/companies',
+                method: 'GET',
+                qs: { limit: '1' },
+            },
+        };
+    }
+}
+exports.TwentyCrmApi = TwentyCrmApi;
+//# sourceMappingURL=TwentyCrmApi.credentials.js.map

package/dist/credentials/TwentyCrmApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TwentyCrmApi.credentials.js","sourceRoot":"","sources":["../../credentials/TwentyCrmApi.credentials.ts"],"names":[],"mappings":";;;AAQA,MAAa,YAAY;IAAzB;QACC,SAAI,GAAG,cAAc,CAAC;QAEtB,gBAAW,GAAG,gBAAgB,CAAC;QAE/B,SAAI,GAAS,0BAA0B,CAAC;QAExC,qBAAgB,GAAG,wCAAwC,CAAC;QAE5D,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,wBAAwB;gBACjC,WAAW,EAAE,4BAA4B;gBACzC,WAAW,EAAE,8DAA8D;aAC3E;YACD;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,4DAA4D;aACzE;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,iCAAiC;iBAChD;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,6BAA6B;gBACtC,GAAG,EAAE,iBAAiB;gBACtB,MAAM,EAAE,KAAK;gBACb,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE;aAClB;SACD,CAAC;IACH,CAAC;CAAA;AA7CD,oCA6CC"}

package/dist/nodes/TwentyCrm/GenericFunctions.d.ts

@@ -0,0 +1,7 @@
+import type { IDataObject, IExecuteFunctions, IHttpRequestMethods, ILoadOptionsFunctions } from 'n8n-workflow';
+import type { ITwentyFilter } from './types';
+export declare function buildFilterString(filters: ITwentyFilter[]): string;
+export declare function buildRequestUrl(serverUrl: string, resource: string, id?: string): string;
+export declare function extractDataFromResponse(response: IDataObject, key: string): unknown;
+export declare function twentyApiRequest(this: IExecuteFunctions | ILoadOptionsFunctions, method: IHttpRequestMethods, resource: string, body?: IDataObject, query?: IDataObject, id?: string): Promise<IDataObject>;
+export declare function twentyApiRequestAllItems(this: IExecuteFunctions, resource: string, query?: IDataObject, limit?: number): Promise<IDataObject[]>;

package/dist/nodes/TwentyCrm/GenericFunctions.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildFilterString = buildFilterString;
+exports.buildRequestUrl = buildRequestUrl;
+exports.extractDataFromResponse = extractDataFromResponse;
+exports.twentyApiRequest = twentyApiRequest;
+exports.twentyApiRequestAllItems = twentyApiRequestAllItems;
+const n8n_workflow_1 = require("n8n-workflow");
+const NUMERIC_RE = /^\d+(\.\d+)?$/;
+const BOOLEAN_RE = /^(true|false)$/;
+const NULL_RE = /^NULL$/;
+const ARRAY_RE = /^\[.*\]$/;
+function buildFilterString(filters) {
+    if (filters.length === 0)
+        return '';
+    return filters
+        .map((f) => {
+        const value = formatFilterValue(f.value, f.comparator);
+        return `${f.field}[${f.comparator}]:${value}`;
+    })
+        .join(',');
+}
+function formatFilterValue(value, comparator) {
+    if (NULL_RE.test(value))
+        return value;
+    if (BOOLEAN_RE.test(value))
+        return value;
+    if (NUMERIC_RE.test(value))
+        return value;
+    if (ARRAY_RE.test(value))
+        return value;
+    if (comparator === 'is')
+        return value;
+    return `"${value}"`;
+}
+function buildRequestUrl(serverUrl, resource, id) {
+    const base = serverUrl.replace(/\/$/, '');
+    const path = id ? `/rest/${resource}/${id}` : `/rest/${resource}`;
+    return `${base}${path}`;
+}
+function extractDataFromResponse(response, key) {
+    if (response.error || response.statusCode) {
+        const messages = response.messages || [response.error];
+        throw new Error(messages.join('; '));
+    }
+    const data = response.data;
+    if (!data) {
+        throw new Error('Response missing data field');
+    }
+    return data[key];
+}
+async function twentyApiRequest(method, resource, body, query, id) {
+    const credentials = await this.getCredentials('twentyCrmApi');
+    const serverUrl = credentials.serverUrl.replace(/\/$/, '');
+    const options = {
+        method,
+        url: buildRequestUrl(serverUrl, resource, id),
+        json: true,
+        body: body && Object.keys(body).length > 0 ? body : undefined,
+        qs: query && Object.keys(query).length > 0 ? query : undefined,
+    };
+    try {
+        return (await this.helpers.httpRequestWithAuthentication.call(this, 'twentyCrmApi', options));
+    }
+    catch (error) {
+        throw new n8n_workflow_1.NodeApiError(this.getNode(), error);
+    }
+}
+async function twentyApiRequestAllItems(resource, query = {}, limit) {
+    const results = [];
+    let hasNextPage = true;
+    query.limit = limit ? Math.min(limit, 60) : 60;
+    while (hasNextPage) {
+        const response = await twentyApiRequest.call(this, 'GET', resource, undefined, query);
+        const pageInfo = response.pageInfo;
+        const data = response.data;
+        if (data) {
+            const items = data[resource];
+            if (items) {
+                results.push(...items);
+            }
+        }
+        if (limit && results.length >= limit) {
+            return results.slice(0, limit);
+        }
+        if ((pageInfo === null || pageInfo === void 0 ? void 0 : pageInfo.hasNextPage) && pageInfo.endCursor) {
+            query.starting_after = pageInfo.endCursor;
+            hasNextPage = true;
+        }
+        else {
+            hasNextPage = false;
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=GenericFunctions.js.map

package/dist/nodes/TwentyCrm/GenericFunctions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GenericFunctions.js","sourceRoot":"","sources":["../../../nodes/TwentyCrm/GenericFunctions.ts"],"names":[],"mappings":"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"}

package/dist/nodes/TwentyCrm/TwentyCrm.node.d.ts

@@ -0,0 +1,5 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class TwentyCrm implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/TwentyCrm/TwentyCrm.node.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TwentyCrm = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const company_description_1 = require("./resources/company/company.description");
+const company_handler_1 = require("./resources/company/company.handler");
+const person_description_1 = require("./resources/person/person.description");
+const person_handler_1 = require("./resources/person/person.handler");
+const opportunity_description_1 = require("./resources/opportunity/opportunity.description");
+const opportunity_handler_1 = require("./resources/opportunity/opportunity.handler");
+const note_description_1 = require("./resources/note/note.description");
+const note_handler_1 = require("./resources/note/note.handler");
+const task_description_1 = require("./resources/task/task.description");
+const task_handler_1 = require("./resources/task/task.handler");
+class TwentyCrm {
+    constructor() {
+        this.description = {
+            displayName: 'Twenty CRM',
+            name: 'twentyCrm',
+            icon: 'file:../../icons/twenty.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+            description: 'Interact with Twenty CRM API',
+            defaults: {
+                name: 'Twenty CRM',
+            },
+            usableAsTool: true,
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            credentials: [
+                {
+                    name: 'twentyCrmApi',
+                    required: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Resource',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        { name: 'Company', value: 'company' },
+                        { name: 'Note', value: 'note' },
+                        { name: 'Opportunity', value: 'opportunity' },
+                        { name: 'Person', value: 'person' },
+                        { name: 'Task', value: 'task' },
+                    ],
+                    default: 'company',
+                },
+                ...company_description_1.companyOperations,
+                ...company_description_1.companyFields,
+                ...person_description_1.personOperations,
+                ...person_description_1.personFields,
+                ...note_description_1.noteOperations,
+                ...note_description_1.noteFields,
+                ...opportunity_description_1.opportunityOperations,
+                ...opportunity_description_1.opportunityFields,
+                ...task_description_1.taskOperations,
+                ...task_description_1.taskFields,
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const resource = this.getNodeParameter('resource', 0);
+        const operation = this.getNodeParameter('operation', 0);
+        for (let i = 0; i < items.length; i++) {
+            try {
+                let result;
+                switch (resource) {
+                    case 'company':
+                        result = await company_handler_1.handleCompanyOperation.call(this, operation, i);
+                        break;
+                    case 'person':
+                        result = await person_handler_1.handlePersonOperation.call(this, operation, i);
+                        break;
+                    case 'opportunity':
+                        result = await opportunity_handler_1.handleOpportunityOperation.call(this, operation, i);
+                        break;
+                    case 'note':
+                        result = await note_handler_1.handleNoteOperation.call(this, operation, i);
+                        break;
+                    case 'task':
+                        result = await task_handler_1.handleTaskOperation.call(this, operation, i);
+                        break;
+                    default:
+                        throw new Error(`Unknown resource: ${resource}`);
+                }
+                if (Array.isArray(result)) {
+                    for (const item of result) {
+                        returnData.push({ json: item });
+                    }
+                }
+                else {
+                    returnData.push({ json: result });
+                }
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({ json: { error: error.message }, pairedItem: { item: i } });
+                    continue;
+                }
+                throw error;
+            }
+        }
+        return [returnData];
+    }
+}
+exports.TwentyCrm = TwentyCrm;
+//# sourceMappingURL=TwentyCrm.node.js.map

package/dist/nodes/TwentyCrm/TwentyCrm.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TwentyCrm.node.js","sourceRoot":"","sources":["../../../nodes/TwentyCrm/TwentyCrm.node.ts"],"names":[],"mappings":"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"}

package/dist/nodes/TwentyCrm/TwentyCrm.node.json

@@ -0,0 +1,17 @@
+{
+    "node": "n8n-nodes-base.twentyCrm",
+    "nodeVersion": "1.0",
+    "codexVersion": "1.0",
+    "categories": ["Sales"],
+    "resources": {
+        "primaryDocumentation": [
+            {
+                "url": "https://twenty.com/developers/rest-api"
+            }
+        ]
+    },
+    "alias": ["CRM", "Twenty", "Sales", "Contacts", "Deals", "Pipeline"],
+    "subcategories": {
+        "Sales": ["Contact Management", "Deal Tracking"]
+    }
+}

package/dist/nodes/TwentyCrm/resources/company/company.description.d.ts

@@ -0,0 +1,3 @@
+import type { INodeProperties } from 'n8n-workflow';
+export declare const companyOperations: INodeProperties[];
+export declare const companyFields: INodeProperties[];