Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform

Actions290

Overview

This node integrates with the Bitrix24 platform, specifically allowing users to interact with various Bitrix24 resources such as CRM entities and user fields. The "Set User Field Settings" operation under the "User Field" resource enables updating or configuring settings of custom user fields within Bitrix24.

Typical use cases include automating the customization of user fields in Bitrix24 CRM or other modules, for example:

  • Updating field labels or visibility settings programmatically.
  • Changing access or mandatory flags on user-defined fields.
  • Managing user field configurations as part of a larger workflow automation.

This is beneficial when managing large or dynamic Bitrix24 environments where manual configuration would be inefficient.

Properties

Name Meaning
Authentication Method of authenticating API requests:
- OAuth2: Recommended for production.
- Webhook: Simpler but less secure webhook URL.
- API Key: Use Bitrix24 API key authentication.
Options Additional options for the request:
- Access Token: String token used for authentication (if applicable).

Output

The node outputs an array of items, each containing a json object representing the result of the operation. For the "Set User Field Settings" operation, the output JSON typically includes confirmation of the updated user field settings or error details if the update failed.

If an error occurs and the node is configured to continue on failure, the output JSON will contain an error field with the error message, the resource name, and a timestamp.

No binary data output is indicated by the source code.

Dependencies

  • Requires connection to Bitrix24 API via one of the supported authentication methods (OAuth2, Webhook URL, or API Key).
  • Needs appropriate credentials configured in n8n for the chosen authentication method.
  • Relies on internal helper functions to make standard Bitrix24 API calls.
  • No additional external libraries beyond those bundled are required.

Troubleshooting

  • Authentication Errors: Ensure that the selected authentication method is correctly configured with valid credentials or tokens. OAuth2 requires proper token refresh handling.
  • API Call Failures: Network issues or incorrect permissions in Bitrix24 can cause failures. Verify API access rights and endpoint availability.
  • Invalid Parameters: Passing unsupported or malformed parameters for user field settings may cause errors. Validate input values against Bitrix24 API documentation.
  • Error Messages: If the node throws errors, they will appear in the output JSON under the error field when "Continue On Fail" is enabled. Review these messages for clues on misconfiguration or API issues.

Links and References


Note: This summary is based solely on static analysis of the provided source code and property definitions without runtime execution.

Discussion