Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform
Join our community

Actions290

Overview

This node integrates with the Bitrix24 platform, specifically allowing users to update folder metadata within the Bitrix24 Disk resource. It is useful for automating updates to folder properties such as renaming folders or modifying custom attributes in Bitrix24's cloud storage system.

Typical use cases include:

  • Renaming a folder based on workflow conditions.
  • Updating folder metadata after file uploads or organizational changes.
  • Automating folder property management in Bitrix24 as part of larger CRM or business process automation.

Properties

Name Meaning
Authentication Method used to authenticate with Bitrix24: OAuth2 (recommended), Webhook (simpler), or API Key.
Folder ID The unique identifier of the folder to update.
Update Data JSON object containing the fields and values to update on the folder.
Options Additional optional parameters:
- Filter JSON filter criteria (not typically used for update but available).
- Order JSON sort order criteria (not typically used for update but available).
- Start Pagination start position (not typically used for update but available).

Output

The node outputs an array of items where each item contains a json field representing the response from Bitrix24 after attempting to update the folder. This typically includes updated folder details or error information if the update failed.

If the operation fails and "Continue On Fail" is enabled, the output will contain an error object with keys:

  • error: Error message string.
  • resource: The resource name ("disk").
  • timestamp: ISO timestamp of when the error occurred.

No binary data output is indicated by the source code.

Dependencies

  • Requires valid authentication credentials for Bitrix24 via one of these methods:

    • OAuth2 token
    • Webhook URL
    • API key

  • The node depends on Bitrix24 API endpoints for disk/folder operations.

  • No additional external libraries beyond those bundled with the node are required.

  • Proper configuration of credentials in n8n is necessary for successful API calls.

Troubleshooting

  • Common issues:

    • Invalid or expired authentication credentials causing authorization failures.
    • Incorrect Folder ID leading to "folder not found" errors.
    • Malformed JSON in the "Update Data" property causing request failures.
    • Network connectivity issues preventing API communication.

  • Error messages:

    • Errors thrown by the Bitrix24 API will be surfaced in the node output under the error field if "Continue On Fail" is enabled.
    • Typical errors include authentication failures, invalid folder IDs, or permission denied.

  • Resolutions:

    • Verify and refresh authentication credentials.
    • Confirm the Folder ID exists and is accessible.
    • Validate JSON syntax in the update data.
    • Check network access and proxy settings if applicable.

Links and References

Discussion