Description

n8n-nodes-twenty-dynamic

The most dynamic, zero-config integration for Twenty CRM. Custom built n8n community node under active development modelled after the official Notion n8n node for ease of use and dynamic resource and field discovery. It automatically adapts to your Twenty instance custom schema, including custom objects and fields, without requiring node updates. It is a fork of the official Twenty CRM node and extends it with dynamic resource and field discovery.

Unlike older Twenty CRM nodes, this node dynamically adapts to your Twenty instance in real-time. It automatically discovers your custom objects, fields, and schema changes without requiring manual node updates or configuration. The current compatibility target is Twenty CRM 2.50.0 and n8n 2.44.6. See Compatibility for validation scope and limitations.

n8n is a fair-code licensed workflow automation platform.

Twenty CRM is a modern, open-source CRM system built for self hosting

Overview

| Feature | Older Nodes / Forks | n8n-nodes-twenty-dynamic |
| :— | :— | :— |
| Custom Objects | ❌ Requires manual JSON inputs or HTTP Request Nodes | ✅ Auto-discovered instantly |
| Custom Fields | ❌ Often missing or raw JSON | ✅ Native n8n inputs for all types |
| Performance | 🐢 Sequential (slow) | ⚡ Bulk Ops (10-100x faster) |
| System Objects | ❌ Hidden | ✅ Full Access (Attachments, Metadata) |
| Ease of Use | 🔧 Configuration heavy | ✨ Zero-config, smart defaults |

—

🚀 Key Features

✨ Supports Personal and Enterprise Custom Databases and Fields: Automatically fetches all standard and custom objects from your personal Twenty instance

💎 Support for Complex Field Types: Template-based and dynamicinputs for FullName, Links, Currency, Address, Emails, Phones

🔓 Unlocks Access TwentyCRM System Databases: View and edit system databases not normally accessible through the Twenty UI (Company/Person Attachments (attachments), Synced Email Metadata (messages), and more for advanced workflows)

🎯 Smart Field Resolution: Dynamic dropdowns for SELECT/MULTI_SELECT and auto-formatted inputs for specialized types

⚡ High-Performance Bulk Operations: Process thousands of records with 10x-100x speed improvements (Create, Update, Delete, Upsert)

🧬 Dual-API Architecture: Utilizes both Twenty Metadata API and GraphQL introspection for complete field coverage for standard and custom fields. REST API used for execution of queries. Maintain compatibility with older Twenty CRM API structures.

—

📦 Installation

For n8n Self Hosted Community Edition Instances

1. Go to Settings → Community Nodes
2. Select Install
3. Enter package name: @lilremark/n8n-nodes-twenty-dynamic

Requirements

• Twenty CRM: API/schema reviewed against 2.50.0 (2026-10-23).
• n8n: targets 2.44.6, using its n8n-workflow 2.44.2 dependency.
• Node.js: 24 or later, matching the current n8n package requirement; CI uses Node.js 24.
• Development: pnpm 10.34.7 (pinned in package.json).

Automated checks cover schema contracts and mocked node execution. A live Twenty/n8n deployment has not been tested in this review. Older Twenty metadata aliases remain supported, but older product releases are not certified. See the compatibility report.

—

🔧 Configuration

1. Generate API Key

In your Twenty CRM instance:
1. Navigate to Settings → Developers → API
2. Click Create API Key and copy the value

2. Add Credentials in n8n

1. Search for “Twenty API” credentials
2. Enter the following details:
– API Key: The key you copied from Twenty
– Domain: Your Twenty instance URL (e.g., https://api.twenty.com for Cloud or http://localhost:3000 for self-hosting)

> [!IMPORTANT]
> Do not include /graphql or /metadata in the domain. The node handles this automatically.
>
> ✅ Correct: https://api.twenty.com
> ❌ Incorrect: https://api.twenty.com/graphql

—
—

About This Project

Modelled after the official Notion N8N node. Unlike traditional n8n nodes with static operations, this node dynamically discovers the Twenty CRM schema at runtime. It queries the Twenty REST and GraphQL APIs to automatically adapt to:

• Support for all standard and system Twenty objects (Company, Person, Opportunity, etc.)
• Support for all custom databases and fields created in your Twenty instance
• Schema changes and updates without requiring node updates

Key Technical Architecture:

• Dynamic Schema Discovery: Queries /metadata endpoint to get available resources and fields
• Hybrid GraphQL/REST: GraphQL for mutations, REST API for efficient data retrieval and node queries
• Runtime Query Construction: Builds queries dynamically based on user selections
• Intelligent Caching: Fresh schema on execution, cached in editor UI for performance
• Native n8n Integration: Uses n8n’s newest built-in HTTP request functionality for all API calls
• TypeScript: Modern, type-safe development with TypeScript
• Zero Dependencies: No external dependencies, pure n8n functionality

Twenty CRM is an open-source CRM under rapid development. This node stays compatible through dynamic adaptation rather than static operation definitions.
—

Installation

Follow the installation guide in the n8n community nodes documentation.

Quick Install in n8n:

Settings → Community Nodes → Install → @lilremark/n8n-nodes-twenty-dynamic

Or via npm:

npm install @lilremark/n8n-nodes-twenty-dynamic

—

Credentials

Generate an API key in Twenty by following the Twenty API documentation.

Quick Steps:
1. Open your Twenty instance
2. Navigate to Settings → Developers → API
3. Click Create API Key
4. Copy the generated key

In n8n:
1. Click Add Credential and search for “Twenty API”
2. Provide:
– API Key: Your Twenty API key (from above)
– Twenty Domain: Your Twenty instance URL (e.g., http://localhost:3000 or https://twenty.example.com)

Important: Use the root domain only, not the GraphQL endpoint:

• ✅ Correct: https://twenty.example.com
• ❌ Wrong: https://twenty.example.com/graphql

—

Operations

This node dynamically discovers available objects from your Twenty CRM instance and supports the following operations:

Single Record Operations

• Create: Create a new record with intelligent field inputs
• Get: Retrieve a single record by ID
• Update: Update an existing record (partial updates supported)
• Delete: Delete a record by ID (Twenty normally soft-deletes records)
• Create or Update (Upsert): Smart upsert – create if not found, update if exists (match by ID or unique field)
• List/Search: Retrieve multiple records with cursor pagination (60 records per request)

Bulk Operations

Process multiple records in parallel for maximum performance:

• Create Many: Bulk create multiple records (10-20x faster than sequential)
• Get Many: Retrieve multiple records by IDs in parallel
• Update Many: Bulk update multiple records with different field values
• Delete Many: Bulk delete multiple records by IDs
• Create or Update Many (Upsert Many): Bulk smart upsert – create or update multiple records based on unique field matching

Bulk Operations Benefits:

• ⚡ 10-20x faster than sequential operations
• 🛡️ Resilient: Individual failures don’t stop the entire batch
• 📊 Detailed results: Each item returns success/error status with index tracking
• 🔄 Parallel execution: Uses Promise.allSettled() for concurrent processing

Resource Selection

• Database Group: Filter databases by type

– All Databases: Show all available objects (default)
– Standard Databases: Main user-facing Twenty objects (Company, Person, Opportunity, Task, Note, etc.)
– System Databases: Internal meta-objects (Views, Filters, Attachments, etc.) – Advanced users only
– Custom Databases: User-created custom objects

• Database: Select the specific object/database to work with (dynamically filtered based on Database Group)

Smart Field Inputs

The node automatically provides appropriate inputs based on field types:

• FullName fields (Person.name): Individual First Name and Last Name inputs
• Links fields (domainName, linkedinLink): URL and Label inputs
• Currency fields (annualRecurringRevenue): Amount and Currency Code inputs with dropdown
• Address fields: Street, City, State, Postal Code, Country, and Coordinates inputs
• Emails/Phones: Multiple entry support with primary designation
• SELECT/MULTI_SELECT: Dynamic dropdowns with options from your Twenty instance
• Simple fields: Standard text, number, date, and boolean inputs
• Resource-aware: Same field name behaves differently based on object type (e.g., Company.name is text, Person.name is FullName)

Supported Databases

Standard Databases:

• Companies, People, Opportunities, Tasks, Notes
• Workflows, Workflow Runs, Workflow Versions

System Databases:

• Attachments, Calendar Events, Messages, Message Channels, Note Targets, etc.

Custom Databases:

• ✅ All custom databases you create in Twenty
• ✅ Custom fields on standard objects
• ✅ Most custom field types supported
• ⚠️ Some complex object-based custom fields are work-in-progress – please report bugs on GitHub

Note: The majority of custom fields are fully supported. If you encounter issues with specific custom field types, please report them on GitHub.

—

Bug Reporting and Feature Requests

Please report bugs and request features on GitHub Issues.

When reporting bugs, please include:

• Your Twenty CRM version
• Your n8n version
• The database/object you’re working with
• Steps to reproduce the issue
• Expected vs actual behavior
• Any error messages

—

Development Status: Ready to Use for Majority of Operations✅

Production-Ready Features

• ✅ Dual-source architecture: Metadata API + GraphQL introspection
• ✅ Complete field coverage: Custom SELECTs + built-in enums
• ✅ All CRUD operations: Create, Read, Update, Delete, List, Upsert
• ✅ Bulk operations: Create Many, Get Many, Update Many, Delete Many, Upsert Many
• ✅ Complex field types: FullName, Links, Currency, Address, Emails, Phones
• ✅ SELECT/MULTI_SELECT: Dynamic options with real-time loading
• ✅ Automatic field type detection: Template-based inputs (no JSON required)
• ✅ Smart caching: Fresh on execution, cached in editor
• ✅ Zero external dependencies: Native n8n helpers only

Roadmap ⏳

• ⏳ Advanced filter UI improvements
• ⏳ Add support for remaining Twenty complex field types (Rating, etc.)
• ⏳ Support for Twenty “Views” and “Relations” and new AI Features
• ⏳ Support for get Database and Notion style resources

—

Resources

• 📚 n8n Community Nodes Documentation
• 🔧 Twenty Developer Documentation
• 🔗 Twenty GraphQL API Documentation
• 📝 Changelog – Version history and release notes
• 💻 GitHub Repository – Source code and issues
• 📦 npm Package – Package details

—

Compatibility

Reviewed against Twenty CRM 2.50.0 and n8n 2.44.6 on 2026-10-23. Build, lint, schema validation, and mocked execution checks are automated. Live-instance verification remains necessary before production rollout. See COMPATIBILITY.md for the exact checks, dependency decisions, and upstream references.

Credits

Primary Development:

• s-yhc – Dynamic node architecture and custom objects integration

Maintainer:

• Logrui

Community Contributors:

• Testing and feedback from the n8n and Twenty communities
• Bug reports and feature requests via GitHub Issues

—

License: MIT

Support: GitHub Issues

Latest Version: Check npm or GitHub Releases