Package Information
Available Nodes
Documentation
n8n-nodes-bitrix
This is an n8n community node. It lets you use Bitrix24 in your n8n workflows.
Bitrix24 is a powerful collaboration platform that includes CRM, tasks, projects, communications, and more — all in a unified workspace. This node allows you to interact with core Bitrix24 entities such as contacts, leads, companies, and deals.
n8n is a fair-code licensed workflow automation platform.
Installation
Operations
Credentials
Compatibility
Usage
Resources
Version history
Installation
Follow the installation guide in the n8n community nodes documentation.
- Go to Settings > Community Nodes.
- Select Install.
- Enter
n8n-nodes-bitrix
in Enter npm package name. - Agree to the risks of using community nodes: select I understand the risks of installing unverified code from a public source.
- Select Install.
After installing the node, you can use it like any other node. n8n displays the node in search results in the Nodes panel.
Operations
This node supports the following Bitrix24 modules and operations:
Modules
crm.company
crm.contact
crm.deal
crm.lead
- (more coming soon)
Supported operations per entity:
- Create (Add a new entity)
- Get (Get an entity by ID)
- Update (Update an entity by ID)
- Delete (Delete an entity by ID)
- List (Query/filter entities)
- Get Fields Description (Fetch metadata for custom fields)
Each operation supports:
- Field-by-field input or raw JSON input
- Filtering, sorting, and field selection for list queries
Credentials
This node supports two authentication methods:
1. Bitrix Webhook
Use a webhook URL from Bitrix24 (e.g. https://yourdomain.bitrix24.ru/rest/1/abc123xyz/
).
To set this up:
- In Bitrix24, go to Developer tools → Webhooks
- Create an inbound webhook and select required access
- Copy the webhook URL and use it in credentials
2. OAuth2 (Bitrix24 REST API)
If you want to use OAuth2:
- Create an application in Bitrix24
- Use the client ID, secret, and domain in the OAuth2 credential
- Supports automatic token refresh and secure API access
Compatibility
- Tested on:
1.92.2
Known limitations:
- Some custom fields in Bitrix may require extra formatting depending on field type.
Usage
When creating or updating records, you can choose to:
- Fill fields one-by-one (dynamic list of available fields is loaded)
- Or provide the full data in raw JSON
When listing entities, you can:
- Use simple filters (field, operator, value)
- Or provide complex JSON filters (e.g., combined filters, nested conditions)
Field names are loaded dynamically based on selected entity (e.g., crm.contact
), making it easier to work with custom fields.
Resources
Version history
Version | Changes |
---|---|
1.0.0 | Initial release with support for CRM module (contact, company, deal, lead), including create/get/update/delete/list/fields |
1.1.0 | Added support for both OAuth2 and Webhook auth, improved filter and JSON input modes |
1.2.0 | Bug-fixes. Added Custom Method |
Upcoming | Support for tasks, users, and activity logging |