Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform
Join our community

Actions290

Overview

This node integrates with the Bitrix24 platform, specifically enabling operations on its Disk resource. The "Move Folder" operation allows users to move a folder from one location to another within the Bitrix24 Disk storage system. This is useful for organizing files and folders programmatically, automating file management workflows, or integrating Bitrix24 file storage with other systems.

Practical examples include:

  • Automatically moving project folders into archive directories after project completion.
  • Organizing incoming files into client-specific folders based on metadata.
  • Integrating with other automation tools to restructure Bitrix24 Disk storage dynamically.

Properties

Name Meaning
Authentication Method of authenticating with Bitrix24: OAuth2 (recommended), Webhook (simpler but less secure), or API Key authentication.
Folder ID The unique identifier of the folder you want to move.
Destination Folder ID The unique identifier of the target folder where the source folder will be moved.
Options Additional optional parameters:
- Filter JSON-formatted filter criteria to refine selection (usage context-dependent).
- Order JSON-formatted sort order specification (usage context-dependent).
- Start Numeric start position for pagination (usage context-dependent).

Output

The node outputs an array of items representing the result of the move folder operation. Each item contains a json object with details about the moved folder or error information if the operation failed.

  • On success, the output JSON typically includes confirmation data from Bitrix24 about the moved folder.
  • On failure (if "Continue On Fail" is enabled), the output JSON includes an error field with the error message, the resource name ("disk"), and a timestamp.

The node does not explicitly output binary data.

Dependencies

  • Requires valid authentication credentials for Bitrix24 via one of the supported methods (OAuth2, webhook URL, or API key).
  • Needs proper configuration of these credentials in n8n prior to use.
  • Relies on Bitrix24's API endpoints for disk operations.

Troubleshooting

  • Common Issues:

    • Invalid or expired authentication credentials can cause authorization failures.
    • Incorrect Folder IDs or Destination Folder IDs will result in errors indicating that the folder was not found.
    • Insufficient permissions on the Bitrix24 account may prevent moving folders.

  • Error Messages:

    • Errors returned by Bitrix24 API are surfaced in the node output when "Continue On Fail" is enabled.
    • Typical messages include "Folder not found", "Access denied", or "Invalid authentication".

  • Resolutions:

    • Verify and refresh authentication credentials.
    • Double-check folder IDs for correctness.
    • Ensure the authenticated user has necessary permissions to move folders.
    • Enable "Continue On Fail" to capture error details without stopping workflow execution.

Links and References

Discussion