Registry / crm-productivity / n8n-nodes-bitrix

n8n-nodes-bitrix

JSON →
library1.3.0jsnpmunverified

This package, `n8n-nodes-bitrix`, provides a set of community nodes for the n8n workflow automation platform, enabling seamless integration with Bitrix24. Currently at version 1.3.0, it allows n8n workflows to interact with core Bitrix24 entities such as contacts, leads, companies, and deals within the CRM module. The node supports comprehensive CRUD (Create, Get, Update, Delete) operations, along with listing entities and fetching field descriptions for metadata. Key differentiators include support for two robust authentication methods: Bitrix Webhooks for quick setup and OAuth2 for secure, automatically refreshing API access. Developers can choose between field-by-field input for ease of use or raw JSON for advanced, flexible data manipulation, with dynamic field loading to simplify working with custom Bitrix24 fields. While there isn't a strict release cadence, the version history indicates active development with periodic updates adding new features and bug fixes. This node is essential for automating business processes involving Bitrix24 within the n8n ecosystem.

crm-productivitycommunicationworkflow
npm install n8n-nodes-bitrix
github ↗package ↗
INSTALL
IMPORT
SIG · N8N-NODES-BITRIX
N
n8n-nodes-bitrix
crm-productivityjavascriptv1.3.0
Install
—
Import
—
Disk
—
Pass rate
0/ 6
Env Coverage0 / 6
glibc
18–22
musl
18–22
Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
node 18–226 runs
build_error
glibc
node 18–226 runs
build_error
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

Bitrix24 Node
✓ In n8n UI, search 'Bitrix24' in the nodes panel and drag it into your workflow.
✗ import { Bitrix24Node } from 'n8n-nodes-bitrix';
This package is an n8n community node; direct JavaScript/TypeScript imports into user code are not applicable. Nodes are accessed and configured visually within the n8n workflow editor.
Bitrix24 Webhook Credential
✓ In n8n UI, navigate to Settings > Credentials, then select 'Bitrix24 Webhook' to create a new credential.
✗ import { Bitrix24WebhookCredential } from 'n8n-nodes-bitrix/credentials';
Credentials are configured globally in n8n's settings and then selected per node in workflows. Do not attempt to import credential logic directly into user code.
CRM Contact Module
✓ In the Bitrix24 node's configuration, select 'CRM Contact' from the 'Resource' dropdown.
✗ const crmContact = bitrix24Node.getModule('crm.contact');
Module operations (e.g., crm.company, crm.deal) are chosen via dropdowns and other configuration options in the node's visual panel, not through direct programmatic calls from user code.

This conceptual quickstart demonstrates how to install the `n8n-nodes-bitrix` package and configure a Bitrix24 node within an n8n workflow to create a new CRM contact, including setting credentials and inputting data.

/* This is a conceptual representation of configuring an n8n workflow step using the Bitrix24 node. It is not directly runnable JavaScript code but illustrates how the node is used within the n8n UI. */ // 1. Start an n8n workflow (e.g., with a 'Start' node or 'Webhook' trigger). // 2. Add a 'Bitrix24' node: // - Search for 'Bitrix24' in the nodes panel and drag it onto the canvas. // 3. Configure the 'Bitrix24' node's settings: // - Credential: Select an existing 'Bitrix24 Webhook' or 'Bitrix24 OAuth2' credential, // or create a new one using your Bitrix24 Webhook URL (e.g., 'https://yourdomain.bitrix24.ru/rest/1/WEBHOOK_KEY/'). // - Resource: 'CRM Contact' (select from dropdown) // - Operation: 'Create' (select from dropdown) // - Data Input Method: 'Field-by-field' (default) // - Add Fields: // - Field: 'Name', Value: 'Jane' // - Field: 'Last Name', Value: 'Doe' // - Field: 'Email', Value: [{ type: 'WORK', value: 'jane.doe@example.com' }] // - Field: 'Phone', Value: [{ type: 'WORK', value: '+15551234567' }] // // Alternatively, for 'Raw JSON' input: // // - Data Input Method: 'Raw JSON' // // - Raw JSON: Provide a JSON object matching the Bitrix24 API schema for contact creation: // // { // // "fields": { // // "NAME": "Jane", // // "LAST_NAME": "Doe", // // "EMAIL": [{"VALUE":"jane.doe@example.com","VALUE_TYPE":"WORK"}], // // "PHONE": [{"VALUE":"+15551234567","VALUE_TYPE":"WORK"}] // // } // // } // 4. Connect the 'Bitrix24' node to any subsequent nodes if your workflow continues. // 5. Save and activate your n8n workflow to deploy and execute it.
Debug
Known issues
gotchaAs a community node, `n8n-nodes-bitrix` is published by the community and is not officially verified by n8n. Users should be aware of the inherent risks of installing unverified code from public sources, as outlined in the n8n documentation for community nodes.
fix
Review the source code on GitHub (https://github.com/dewocom/n8n-nodes-bitrix) or only install from trusted community sources if security is a critical concern.
affects: >=1.0.0
gotchaSome custom fields in Bitrix24 may require specific data formatting or structure depending on their type (e.g., arrays for multi-select, specific date formats). Incorrect formatting will lead to API errors.
fix
Consult the official Bitrix24 REST API documentation for the specific field types and expected data formats. Use the 'Get Fields Description' operation within the node to inspect metadata for dynamic fields.
affects: >=1.0.0
breakingThe package requires Node.js version 20.15 or newer. Running n8n with an older Node.js version may lead to installation failures or runtime errors.
fix
Ensure your n8n environment (or the underlying system running n8n) is using Node.js version 20.15 or greater. Update your Node.js installation if necessary.
affects: >=1.0.0
gotchaWhile version history indicates active development and feature additions (e.g., OAuth2 in 1.1.0, Custom Method in 1.2.x), explicit 'breaking changes' are not always highlighted. Upgrading between minor or patch versions might introduce subtle behavioral changes that could impact existing workflows if not tested.
fix
Always test community node updates in a staging environment before deploying to production. Review the GitHub repository's release notes or commit history for any unstated changes if a workflow breaks after an update.
affects: >=1.0.0
Errors
Common errors & fixes
Error: Node 'Bitrix24' not found in search results.
The `n8n-nodes-bitrix` package was not correctly installed in your n8n instance, or n8n was not restarted after installation.
fix
Follow the installation guide precisely: Go to Settings > Community Nodes in n8n, install `n8n-nodes-bitrix`, and then restart your n8n instance to ensure the node is loaded.
Error: Invalid Bitrix24 Webhook URL provided. Please check your URL format.
The Bitrix24 Webhook URL configured in the credential is incorrect, incomplete, or lacks the necessary permissions.
fix
Verify the webhook URL directly from your Bitrix24 developer tools section. Ensure it starts with `https://yourdomain.bitrix24.ru/rest/1/...` and has the required access rights configured in Bitrix24.
Error: Request failed with status code 400 (Bad Request). Response: { 'error': 'Incorrect value for field NAME' }
The data provided for a Bitrix24 field (e.g., 'NAME') does not conform to Bitrix24's API expectations for that field type, or a required field is missing.
fix
Review the specific field's requirements in the Bitrix24 REST API documentation. Ensure all mandatory fields are present and their values match the expected data type and format. Use 'Get Fields Description' operation to debug.
Node.js version mismatch: This package requires Node.js >=20.15.0.
Your n8n environment is running an older version of Node.js than required by the community node.
fix
Upgrade your Node.js installation to version 20.15.0 or newer. If using Docker, ensure your Dockerfile or image specifies a compatible Node.js version.
Upgrade
Version history
1.3.0latest on npm
Audit
Dependencies
n8n-workflowrequiredThis is an n8n community node and requires the n8n core workflow engine to function.
Agent activity
32 hits · last 30 days
node
28
OpenAI (training)
1
Resources
githubhttps://github.com/dewocom/n8n-nodes-bitrix ↗
packagehttps://www.npmjs.com/package/n8n-nodes-bitrix ↗