Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform

Actions290

Overview

The node interacts with the Bitrix24 platform, specifically providing operations on various resources such as CRM entities and disk storage. For the Disk resource with the Get Folders operation, it retrieves information about folders stored in Bitrix24's file storage system.

This operation is useful when you want to programmatically access folder metadata within Bitrix24, for example:

  • Listing subfolders inside a specific folder.
  • Retrieving folder details before uploading or managing files.
  • Automating backup or synchronization tasks involving Bitrix24 disk folders.

Properties

Name Meaning
Authentication Method of authenticating with Bitrix24: OAuth2 (recommended), Webhook URL (simpler), or API Key.
Folder ID The unique identifier of the folder to retrieve information about.
Options Additional optional parameters:
- Filter JSON object specifying filter criteria to narrow down folder results.
- Order JSON object defining sorting order of the returned folders.
- Start Number indicating the start position for pagination (offset).

Output

The node outputs an array of items where each item's json property contains the folder data retrieved from Bitrix24. This typically includes folder metadata such as folder ID, name, creation date, modification date, and other relevant attributes depending on Bitrix24's API response.

If the node supports binary data output (not explicitly shown here), it would represent file contents or attachments related to folders, but for this operation, the focus is on JSON metadata.

Dependencies

  • Requires valid authentication credentials for Bitrix24 via one of the supported methods (OAuth2, webhook URL, or API key).
  • Relies on Bitrix24's REST API endpoints for disk folder management.
  • No additional external libraries beyond those bundled with the node are required.
  • Proper configuration of authentication credentials in n8n is necessary.

Troubleshooting

  • Common issues:

    • Invalid or expired authentication credentials will cause API calls to fail.
    • Incorrect Folder ID may result in errors or empty responses.
    • Improperly formatted JSON in the Filter or Order options can cause parsing errors.
    • Pagination parameters might need adjustment if large folder lists are expected.
  • Error messages:

    • Errors from Bitrix24 API will be surfaced with their message in the output under an error field if "Continue On Fail" is enabled.
    • Typical errors include authentication failures, permission denied, or folder not found.
  • Resolutions:

    • Verify and refresh authentication credentials.
    • Double-check Folder ID correctness.
    • Validate JSON syntax in filter/order fields.
    • Use pagination options to handle large datasets.

Links and References

Discussion