n8n-nodes-twenty

n8n community node for Twenty CRM — the Open Source CRM platform

✨ Features

📥 Installation

Via n8n UI (Recommended)

1. Go to Settings → Community Nodes
2. Click Install a community node
3. Enter: @linkedpromo/n8n-nodes-twenty
4. Click Install

Via npm

npm install @linkedpromo/n8n-nodes-twenty

🔑 Configuration

Step 1: Get Your API Key

1. Log into your Twenty CRM instance
2. Go to Settings → Developers → API Keys
3. Create a new API key or copy an existing one

Step 2: Add Credentials in n8n

1. Go to Credentials → Add Credential → Twenty CRM API
2. Fill in the fields:

⚠️ Important: URL must be WITHOUT trailing slash (/) and WITHOUT /rest

📋 Supported Operations

TwentyCrm Node

TwentyCrmTrigger Node

🧩 Custom Objects

Work with any Twenty CRM custom object using the Custom Object resource:

1. Select Custom Object as the resource
2. Enter the Object API Name (e.g., customLeads, myCustomObject)
3. Provide fields as JSON

{
  "customField1": "value1",
  "customField2": "value2"
}

💡 Find your object's API name in Twenty CRM Settings → Data Model → Your Object → API Name

📋 Dynamic Dropdowns

The node automatically loads data from your CRM for convenient selection:

💡 Dropdowns show up to 60 items. For more, use the record ID directly.

🔁 Automatic Retry

The node automatically retries failed requests for transient errors:

• Exponential backoff: 1s → 2s → 4s (with jitter)
• Respects Retry-After header from API
• No retry for client errors (400, 401, 403, 404)

🔄 Auto Field Transformation

The node automatically transforms simple values to Twenty's complex format:

{
  "name": "Acme Inc",
  "domainName": "acme.com"
}

{
  "name": "Acme Inc",
  "domainName": {
    "primaryLinkUrl": "https://acme.com",
    "primaryLinkLabel": "",
    "secondaryLinks": []
  }
}

{
  "firstName": "John",
  "lastName": "Doe",
  "email": "john@example.com"
}

{
  "name": {
    "firstName": "John",
    "lastName": "Doe"
  },
  "emails": {
    "primaryEmail": "john@example.com",
    "additionalEmails": []
  }
}

⚠️ Note: Twenty CRM Notes API does NOT support a body field. Only title and position are available.

🔧 Troubleshooting

🐌 Node hangs / timeout

+ ✅ Correct:   https://your-twenty-instance.com
- ❌ Wrong:     https://your-twenty-instance.com/
- ❌ Wrong:     https://your-twenty-instance.com/rest

🔄 Node still doesn't work after changing credentials

Solution: Delete the node completely and add a new one with correct credentials

❌ Common API Errors

📦 Compatibility

🧪 Development

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Lint
npm run lint

🔗 Links

📄 License

MIT License — see LICENSE for details.

Made with ❤️ by abm24