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 sharing rights for files or folders stored in Bitrix24's Disk resource. It is useful when you want to programmatically modify access permissions on shared items within Bitrix24, such as granting or revoking user or group access to specific files or folders.

Practical scenarios include:

  • Automating permission updates after uploading or modifying documents.
  • Synchronizing sharing settings based on external workflows or triggers.
  • Managing collaborative access control in business processes.

Properties

Name Meaning
Authentication Method of authenticating with Bitrix24: OAuth2 (recommended), Webhook (simpler), or API Key.
Item ID The unique identifier of the file or folder whose sharing rights are to be updated.
Sharing Data JSON object specifying the new sharing configuration (e.g., users, groups, and their rights).
Options Additional optional parameters:
• Filter: JSON criteria to filter results.
• Order: JSON defining sort order.
• Start: Number indicating pagination start position.

Output

The node outputs an array of items where each item contains a json field representing the response from Bitrix24 after updating sharing rights. This typically includes confirmation of the update or details about the current sharing state of the specified item.

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

  • error: The error message.
  • resource: The resource name ("disk").
  • timestamp: The time the error occurred.

No binary data output is indicated for this operation.

Dependencies

  • Requires valid authentication credentials for Bitrix24 via one of the supported methods (OAuth2, webhook URL, or API key).
  • The node depends on Bitrix24's API endpoints related to Disk resource sharing management.
  • Proper configuration of authentication credentials in n8n is necessary before use.

Troubleshooting

  • Common Issues:

    • Invalid or expired authentication tokens can cause authorization failures.
    • Incorrect or missing Item ID will result in errors as the target file/folder cannot be found.
    • Malformed JSON in the Sharing Data property may cause request failures.

  • Error Messages:

    • Authorization errors: Check that the selected authentication method is correctly configured and valid.
    • "Item not found": Verify the Item ID corresponds to an existing file or folder in Bitrix24 Disk.
    • JSON parsing errors: Ensure the Sharing Data JSON is well-formed and matches Bitrix24 API expectations.

  • Resolution Tips:

    • Refresh or reconfigure authentication credentials if authorization fails.
    • Double-check the Item ID value for correctness.
    • Validate JSON syntax using online tools before inputting into the node.

Links and References

Discussion