Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform
Join our community

Actions290

Overview

The Bitrix24 node allows interaction with the Bitrix24 CRM and business platform. Specifically, for the File resource with the Copy File operation, this node copies a file within the Bitrix24 environment from one folder to another. This is useful when you want to duplicate files for backup, organization, or sharing purposes without altering the original file.

Practical examples include:

  • Copying a document from a shared folder to a personal workspace.
  • Duplicating marketing materials into different campaign folders.
  • Creating backups of important files before making edits.

Properties

Name Meaning
Authentication Method used to authenticate with Bitrix24: OAuth2 (recommended), Webhook (simpler), or API Key.
Target Folder ID The ID of the destination folder where the file will be copied.
New Name Optional new name for the copied file. If left empty, the original file name is retained.
Folder ID The ID of the source folder containing the file. Leave empty if the file is in the root folder.
File ID The unique identifier of the file to copy.
Options > Access Token Optional access token string for authentication override.

Output

The node outputs JSON data representing the result of the copy operation. This typically includes metadata about the newly copied file such as its ID, name, location, and other relevant attributes returned by the Bitrix24 API.

If binary data were involved (e.g., file contents), it would be summarized here, but for the copy operation, the output focuses on JSON metadata only.

Dependencies

  • Requires an active connection to Bitrix24 via one of the supported authentication methods (OAuth2, webhook URL, or API key).
  • Proper configuration of credentials in n8n is necessary to authenticate API calls.
  • The node relies on Bitrix24's API endpoints to perform file operations.

Troubleshooting

  • Common issues:

    • Invalid or expired authentication tokens can cause authorization failures.
    • Incorrect folder or file IDs may lead to "file not found" or "folder not found" errors.
    • Insufficient permissions in Bitrix24 to read from the source folder or write to the target folder.

  • Error messages:

    • Errors returned from Bitrix24 API are surfaced in the node output under an error field if "Continue On Fail" is enabled.
    • Typical error messages include authentication failures, invalid IDs, or permission denials.

  • Resolutions:

    • Verify that the authentication credentials are valid and have not expired.
    • Double-check the folder and file IDs for correctness.
    • Ensure the authenticated user has appropriate permissions in Bitrix24.
    • Use the "New Name" property carefully to avoid naming conflicts.

Links and References

Discussion