Actions89
- Direct API Actions
- CRM Actions
- Task Actions
- User Actions
- SPA Actions
- Activity Actions
- Automation Actions
- Document Generator Actions
- Data Storage Actions
- Chat Actions
Overview
The node integrates with the Bitrix24 platform, specifically enabling interaction with its CRM and business resources. For the Data Storage > Get Items operation, it retrieves a list of items from a specified Bitrix24 entity or resource. This is useful for workflows that need to fetch records such as contacts, deals, leads, companies, or custom Smart Process Automation (SPA) entities from Bitrix24.
Common scenarios include:
- Synchronizing Bitrix24 CRM data with other systems.
- Automating reporting by extracting lists of CRM items.
- Triggering downstream processes based on retrieved data sets.
- Filtering and ordering data retrieval to optimize workflow logic.
Example: Fetch all deals created in the last month, ordered by creation date, to generate a sales report.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method to authenticate with Bitrix24: - OAuth2 (recommended for production) - Webhook (simpler but less secure) - API Key |
| Return All | Boolean flag indicating whether to return all matching results or limit the number of returned items. |
| Options | Collection of optional parameters: • Access Token: string token for authentication • Filter: JSON object specifying filter criteria • Select: Comma-separated list of fields to retrieve • Order: JSON object defining sorting order • Start: Number indicating pagination start position |
Output
The node outputs an array of JSON objects representing the retrieved Bitrix24 items. Each item corresponds to a record from the selected resource/entity and includes fields as specified by the "Select" option or defaults to all available fields.
If binary data is present in the resource (not typical for this operation), it would be included accordingly, but this operation primarily returns structured JSON data.
In case of errors and if "Continue On Fail" is enabled, the output will contain an error object with:
error: The error message.resource: The resource name involved.timestamp: ISO timestamp of the error occurrence.
Dependencies
- Requires valid authentication credentials for Bitrix24 via one of the supported methods (OAuth2, webhook URL, or API key).
- The node depends on Bitrix24's REST API endpoints to fetch data.
- No additional external services are required beyond Bitrix24 itself.
- Proper configuration of authentication credentials in n8n is necessary.
Troubleshooting
- Authentication Errors: Ensure the chosen authentication method is correctly configured and tokens/keys are valid and not expired.
- API Rate Limits: Bitrix24 may impose rate limits; excessive requests might cause failures.
- Invalid Filters or Fields: Malformed JSON in filter/order options or invalid field names can cause API errors.
- Empty Results: If no items match the filter criteria, the output will be empty; verify filters and pagination settings.
- Error Handling: If the node throws errors, enabling "Continue On Fail" allows workflows to handle errors gracefully.