Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform
Join our community

Actions290

Overview

This node interacts with the Bitrix24 platform, specifically to retrieve a list of files from a specified folder within Bitrix24's file storage. The "Get All Files" operation under the "File" resource allows users to fetch multiple files or folders, optionally filtered by type or name, and supports pagination to handle large result sets.

Common scenarios include:

  • Automating backup or synchronization of files stored in Bitrix24.
  • Listing files for further processing or integration with other systems.
  • Filtering files by type (file or folder) or by partial name matching to locate specific documents.

For example, a user might want to retrieve all files in the root directory or a specific folder, filtering only for folders to build a directory tree structure.

Properties

Name Meaning
Authentication Method used to authenticate with Bitrix24: OAuth2 (recommended), Webhook URL (simpler but less secure), or API Key authentication.
Folder ID ID of the folder to list files from; leave empty to list files from the root folder.
Filter Collection of filters to narrow down results:
• File Type: All, File, or Folder
• Name Contains: filter files whose names contain this text
• Access Token: optional token for authentication override.
Return All Boolean flag indicating whether to return all available results or just a subset.
Max Pages to Load When not returning all, limits how many pages of results to load (each page contains up to 50 items).

Output

The node outputs an array of JSON objects representing files and/or folders retrieved from Bitrix24. Each item in the output corresponds to a file or folder with its associated metadata as returned by the Bitrix24 API.

If binary data is included (not explicitly shown in the provided code), it would represent the actual file content, but this operation primarily returns metadata listings.

The output JSON typically includes fields such as file/folder ID, name, type, and other relevant attributes depending on Bitrix24's API response.

Dependencies

  • Requires access to Bitrix24 API via one of the supported authentication methods (OAuth2, webhook URL, or API key).
  • Proper credentials must be configured in n8n for the chosen authentication method.
  • Network connectivity to Bitrix24 endpoints.
  • No additional external libraries beyond those bundled are required.

Troubleshooting

  • Authentication errors: Ensure that the selected authentication method is correctly configured with valid credentials or tokens.
  • Empty results: Verify the Folder ID is correct; an empty string targets the root folder. Also check filter criteria to avoid overly restrictive filters.
  • Pagination limits: If not returning all results, the Max Pages to Load property limits how many pages are fetched. Increase if more results are expected.
  • API rate limits or timeouts: Bitrix24 may throttle requests; consider adding delays or handling retries externally.
  • Error messages: Errors thrown during execution will include the error message from Bitrix24 API. Use these messages to diagnose issues like invalid parameters or permission problems.

Links and References

Discussion