Actions290
- Task Actions
- Direct API Actions
- CRM Actions
- User Actions
- SPA Actions
- Activity Actions
- Automation Actions
- Document Generator Actions
- Data Storage Actions
- Get Entity
- Add Entity
- Update Entity
- Delete Entity
- Get Entity Rights
- Get Entity Sections
- Add Entity Section
- Update Entity Section
- Delete Entity Section
- Get Entity Item
- Add Entity Item
- Update Entity Item
- Delete Entity Item
- Get Entity Item Properties
- Add Entity Item Property
- Update Entity Item Property
- Delete Entity Item Property
- Chat Actions
- User Field Actions
- File Actions
- User Field Config Actions
- Duplicate Actions
- Timeline Actions
- Disk Actions
- Upload File
- Download File
- Delete File
- Get File Info
- List Files
- Create Folder
- Delete Folder
- Get Storage Info
- Get Storages
- Get Storage
- Get Folders
- Get Folder
- Add Folder
- Update Folder
- Copy Folder
- Move Folder
- Rename Folder
- Get Files
- Get File
- Copy File
- Move File
- Rename File
- Share Item
- Get Shared Items
- Get Sharing Rights
- Update Sharing Rights
- Workflow Actions
- Status Actions
- Calendar Actions
- Chatbot Actions
- Events Actions
- Lists Actions
- Product Actions
- Open Lines Actions
- Telephony Actions
- Register External Call
- Finish External Call
- Hide External Call
- Show External Call
- Search CRM Entities
- Attach Call Record
- Get External Line
- Add External Line
- Update External Line
- Delete External Line
- Get Voximplant Statistics
- Get Voximplant Line
- Get Voximplant SIP Connector
- Get Voximplant SIP Line
- Add Voximplant SIP Line
- Update Voximplant SIP Line
- Delete Voximplant SIP Line
- Message Service Actions
- Notify Actions
Overview
This node integrates with the Bitrix24 platform, specifically enabling operations on various Bitrix24 resources. For the Disk resource and the Share Item operation, it allows users to share a file or folder stored in Bitrix24's disk storage by configuring sharing settings.
Typical use cases include:
- Automating the sharing of documents or folders within Bitrix24 after they are uploaded or updated.
- Setting specific sharing permissions programmatically based on workflow conditions.
- Integrating Bitrix24 file sharing into broader automation workflows, such as notifying team members or external partners when a file is shared.
Example: After uploading a contract document to Bitrix24 Disk, this node can be used to share that document with specified users or groups by providing the item ID and sharing configuration.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method to authenticate with Bitrix24 API: - OAuth2 (recommended for production) - Webhook (simpler but less secure) - API Key |
| Item ID | The unique identifier of the file or folder in Bitrix24 Disk that you want to share. |
| Sharing Data | JSON object defining the sharing configuration, such as access rights, users/groups to share with, expiration, etc. |
| Options | Additional optional parameters: - Filter: JSON criteria to filter results - Order: JSON to specify sorting order - Start: Number indicating pagination start position |
Output
The node outputs an array of items where each item's json property contains the response from Bitrix24 API regarding the sharing action. This typically includes confirmation details about the shared item, such as sharing status or any metadata returned by the API.
If an error occurs and "Continue On Fail" is enabled, the output will contain an item with an error field describing the issue, along with the resource name and a timestamp.
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 REST API endpoints for disk operations.
- Proper permissions in Bitrix24 are necessary to share files/folders.
- No additional external services beyond Bitrix24 API are required.
Troubleshooting
Common issues:
- Invalid or expired authentication credentials leading to authorization errors.
- Incorrect or non-existent Item ID causing "item not found" errors.
- Malformed JSON in the Sharing Data property causing request failures.
- Insufficient permissions in Bitrix24 to share the specified item.
Error messages:
- Authorization errors: Check that the provided authentication method is correctly configured and tokens/keys are valid.
- Item not found or invalid ID: 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.
- API rate limits or connectivity issues: Retry after some time or check network connectivity.
Enabling "Continue On Fail" allows workflows to handle errors gracefully by capturing error details in the output.