Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform

Actions290

Overview

This node interacts with Bitrix24's Lists resource to retrieve a file associated with a specific list element. It is useful when you need to programmatically access files stored in Bitrix24 lists, such as documents, images, or attachments linked to list items.

Common scenarios include:

  • Automating the download or processing of files attached to list elements.
  • Integrating Bitrix24 list files into workflows for further handling (e.g., sending via email, storing in other systems).
  • Extracting files from Bitrix24 lists for backup or reporting purposes.

Example: You have a Bitrix24 list tracking project documents, and you want to automatically fetch the latest version of a document attached to a particular list item for processing in another system.

Properties

Name Meaning
Authentication Method to authenticate with Bitrix24. Options: OAuth2 (recommended), Webhook (simpler), API Key.
List ID The identifier of the Bitrix24 list containing the element.
Element ID The identifier of the specific element within the list whose file you want to retrieve.
Options Additional optional parameters:
- Access Token Use a specific access token instead of the one from credentials.
- Filter JSON-formatted filter criteria (not typically used for this operation).
- Order JSON-formatted sort order (not typically used for this operation).
- Select Comma-separated list of fields to select (not typically used for this operation).

Output

The node outputs the retrieved file data related to the specified list element. The output includes a json field containing metadata about the file and may include binary data representing the file content.

  • json: Contains information about the file, such as its URL, name, size, or other metadata depending on Bitrix24's response.
  • Binary data (if applicable): Represents the actual file content fetched from Bitrix24, enabling downstream nodes to process or save the file.

Dependencies

  • Requires authentication with Bitrix24 via one of the supported methods: OAuth2, webhook URL, or API key.
  • Needs proper configuration of credentials in n8n corresponding to the chosen authentication method.
  • Relies on Bitrix24 API endpoints to fetch list element files.

Troubleshooting

  • Authentication errors: Ensure that the selected authentication method is correctly configured and valid. For OAuth2, verify token validity; for webhooks and API keys, confirm correct values.
  • Invalid List ID or Element ID: Double-check that the provided IDs exist and are accessible with the current credentials.
  • File not found or empty response: The specified element might not have an associated file, or the file permissions restrict access.
  • API rate limits or connectivity issues: Bitrix24 may throttle requests or experience downtime; retry after some time or check network connectivity.
  • Malformed options JSON: If using filter or order options, ensure the JSON syntax is correct to avoid parsing errors.

Links and References

Discussion