Actions25
Overview
This node integrates with the Bitrix24 CRM system to manage Contact records. Specifically, the List operation for the Contact resource retrieves multiple contact records from Bitrix24. It supports returning all contacts or a limited subset, optionally filtered by various field criteria, and allows selecting specific fields to be returned.
Common scenarios where this node is beneficial include:
- Synchronizing contacts from Bitrix24 into another system.
- Generating reports or lists of contacts based on custom filters.
- Extracting subsets of contacts for marketing campaigns or outreach.
For example, you could use this node to fetch all contacts whose email contains a certain domain or to retrieve only the first 100 contacts with phone numbers listed.
Properties
| Name | Meaning |
|---|---|
| Return All | Boolean flag to return all matching contact records without limit. |
| Limit | Maximum number of contact records to return (used if Return All is false). |
| Use Filter | Boolean flag to enable filtering of contacts based on specified field conditions. |
| Filter Fields | Collection of filter conditions; each includes: |
| - Field Name: The contact field to filter by (loaded dynamically from Bitrix24). | |
| - Operation: The comparison operation to apply (Equals, Not Equals, Greater Than, Contains, etc.). | |
| - Value: The value to compare the field against. | |
| Select Fields | List of contact fields to retrieve in the output. If empty, default fields are returned. |
Output
The node outputs an array of JSON objects representing contact records retrieved from Bitrix24. Each object contains key-value pairs corresponding to the selected fields of a contact.
- If no specific fields are selected, a default set of fields is returned.
- When filters are applied, only contacts matching those criteria appear.
- If "Return All" is enabled, all matching contacts are returned; otherwise, the output respects the specified limit.
The node does not output binary data.
Dependencies
- Requires an active Bitrix24 API connection configured via an API authentication token or webhook URL credential.
- The node uses the Bitrix24 REST API endpoints to query contact data.
- Network access to the Bitrix24 instance's webhook URL must be available.
- No additional external dependencies beyond standard HTTP requests.
Troubleshooting
- Missing Credentials or Webhook URL: The node will error if the Bitrix24 API credentials or webhook URL are not provided or invalid. Ensure credentials are correctly configured in n8n.
- Invalid Filter Fields: Using incorrect field names or unsupported operations in filters may cause errors or empty results. Use the dynamic field loader to select valid fields.
- API Rate Limits or Timeouts: Large queries with "Return All" enabled might hit API limits or time out. Consider using filters or limits to reduce data volume.
- Empty Results: If no contacts match the filter criteria, the output will be empty. Verify filter values and operations.
- JSON Parsing Errors: When using JSON input format for other operations, malformed JSON can cause failures. For the List operation, this is not applicable.
Links and References
- Bitrix24 REST API Documentation
- Bitrix24 CRM Contacts API Reference
- n8n Documentation on Creating Custom Nodes