Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform
Join our community

Actions290

Overview

This node interacts with the Bitrix24 platform, specifically focusing on operations related to the "Disk" resource. The "Get Folder" operation retrieves information about a specific folder in the Bitrix24 disk storage system by its ID. This is useful for workflows that need to access or manipulate files and folders stored within Bitrix24's cloud storage.

Common scenarios include:

  • Automating file management tasks such as retrieving folder metadata before uploading or moving files.
  • Integrating Bitrix24 disk storage with other systems by fetching folder details.
  • Building custom dashboards or reports that require folder information from Bitrix24.

Example: A workflow that triggers when a new folder is created in Bitrix24 and then fetches its details to log or process further.

Properties

Name Meaning
Authentication Method of authenticating with Bitrix24. Options: OAuth2 (recommended), Webhook (simpler), API Key.
Folder ID The unique identifier of the folder to retrieve.
Options Additional optional parameters:
- Filter JSON object specifying filter criteria to narrow down results.
- Order JSON object defining the sort order of returned data.
- Start Number indicating the start position for pagination (offset).

Output

The node outputs an array of items where each item's json property contains the folder data retrieved from Bitrix24. This typically includes folder metadata such as folder ID, name, creation date, modification date, and possibly nested folder or file information depending on the API response.

If the node supports binary data output (not explicitly shown here), it would represent file contents or attachments related to the folder, but this operation primarily returns JSON metadata.

Dependencies

  • Requires authentication credentials for Bitrix24 via one of the supported methods: OAuth2, webhook URL, or API key.
  • Uses Bitrix24 API endpoints internally to fetch folder information.
  • No additional external services are required beyond Bitrix24 itself.
  • Proper configuration of credentials in n8n is necessary for successful API calls.

Troubleshooting

  • Common issues:

    • Invalid or missing Folder ID will cause the API call to fail.
    • Incorrect authentication setup can lead to authorization errors.
    • Network connectivity problems may prevent reaching Bitrix24 API.
    • Improperly formatted JSON in filter or order options can cause request failures.

  • Error messages:

    • Errors returned from Bitrix24 API will be included in the output if "Continue On Fail" is enabled.
    • Typical error messages include "Folder not found", "Unauthorized", or "Invalid parameter".

  • Resolutions:

    • Verify the Folder ID exists and is accessible with the provided credentials.
    • Ensure the selected authentication method is correctly configured and valid.
    • Validate JSON syntax in filter and order fields.
    • Check network connectivity and Bitrix24 service status.

Links and References

Discussion