Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform

Actions290

Overview

This node integrates with the Bitrix24 platform, specifically enabling file management operations such as uploading files to Bitrix24's storage. The "Upload File" operation under the "File" resource allows users to upload a file by specifying its name, content, and target folder within Bitrix24.

Common scenarios for this node include:

  • Automating document uploads to Bitrix24 from other systems or workflows.
  • Storing generated reports or exports directly into Bitrix24 folders.
  • Integrating file attachments into CRM records or projects managed in Bitrix24.

For example, a user could automate uploading a PDF invoice generated in another system directly into a specific Bitrix24 folder for record keeping.

Properties

Name Meaning
Authentication Method of authenticating with Bitrix24: OAuth2 (recommended), Webhook URL (simpler), or API Key.
Folder ID ID of the destination folder in Bitrix24 where the file will be uploaded. Leave empty for root.
File Name The name to assign to the uploaded file.
File Content The content of the file to upload. For binary files, this should be base64 encoded.
Options Additional optional settings:
- Generate Unique Name If true, generates a unique filename if a file with the same name already exists.
- Rights JSON object defining access rights for the uploaded file.
- Access Token Optional access token string for authentication override.

Output

The node outputs an array of items, each containing a json property with details about the uploaded file. This typically includes metadata returned by Bitrix24 after a successful upload, such as file ID, name, size, and possibly URLs or paths.

If the node supports binary data output (not explicitly shown here), it would represent the uploaded file or related binary content accordingly.

Dependencies

  • Requires valid authentication credentials for Bitrix24 via one of the supported methods (OAuth2, webhook URL, or API key).
  • The node internally uses Bitrix24 API calls to perform file uploads.
  • No additional external dependencies beyond Bitrix24 API access are required.
  • Proper configuration of authentication credentials in n8n is necessary.

Troubleshooting

  • Authentication errors: Ensure that the selected authentication method is correctly configured with valid credentials or tokens.
  • Invalid Folder ID: If the folder ID does not exist or is incorrect, the upload will fail. Verify the folder ID or leave empty to upload to root.
  • File content issues: For binary files, ensure the content is properly base64 encoded; otherwise, the upload may result in corrupted files.
  • Name conflicts: If a file with the same name exists and "Generate Unique Name" is false, the upload might overwrite or fail depending on Bitrix24 behavior.
  • API limits or permissions: Insufficient permissions or API rate limits can cause errors. Check Bitrix24 user permissions and API usage quotas.

Common error messages usually contain the API error message from Bitrix24, which can guide resolution steps such as fixing authentication, correcting parameters, or adjusting permissions.

Links and References

Discussion