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 interacts with Bitrix24's Lists resource to retrieve a file associated with a specific list element. It is useful when you need to programmatically access files stored in Bitrix24 lists, such as documents, images, or attachments linked to list items.
Common scenarios include:
- Automating the download or processing of files attached to list elements.
- Integrating Bitrix24 list files into workflows for further handling (e.g., sending via email, storing in other systems).
- Extracting files from Bitrix24 lists for backup or reporting purposes.
Example: You have a Bitrix24 list tracking project documents, and you want to automatically fetch the latest version of a document attached to a particular list item for processing in another system.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method to authenticate with Bitrix24. Options: OAuth2 (recommended), Webhook (simpler), API Key. |
| List ID | The identifier of the Bitrix24 list containing the element. |
| Element ID | The identifier of the specific element within the list whose file you want to retrieve. |
| Options | Additional optional parameters: |
| - Access Token | Use a specific access token instead of the one from credentials. |
| - Filter | JSON-formatted filter criteria (not typically used for this operation). |
| - Order | JSON-formatted sort order (not typically used for this operation). |
| - Select | Comma-separated list of fields to select (not typically used for this operation). |
Output
The node outputs the retrieved file data related to the specified list element. The output includes a json field containing metadata about the file and may include binary data representing the file content.
json: Contains information about the file, such as its URL, name, size, or other metadata depending on Bitrix24's response.- Binary data (if applicable): Represents the actual file content fetched from Bitrix24, enabling downstream nodes to process or save the file.
Dependencies
- Requires authentication with Bitrix24 via one of the supported methods: OAuth2, webhook URL, or API key.
- Needs proper configuration of credentials in n8n corresponding to the chosen authentication method.
- Relies on Bitrix24 API endpoints to fetch list element files.
Troubleshooting
- Authentication errors: Ensure that the selected authentication method is correctly configured and valid. For OAuth2, verify token validity; for webhooks and API keys, confirm correct values.
- Invalid List ID or Element ID: Double-check that the provided IDs exist and are accessible with the current credentials.
- File not found or empty response: The specified element might not have an associated file, or the file permissions restrict access.
- API rate limits or connectivity issues: Bitrix24 may throttle requests or experience downtime; retry after some time or check network connectivity.
- Malformed options JSON: If using filter or order options, ensure the JSON syntax is correct to avoid parsing errors.