Actions89
- Direct API Actions
- CRM Actions
- Task Actions
- User Actions
- SPA Actions
- Activity Actions
- Automation Actions
- Document Generator Actions
- Data Storage Actions
- Chat Actions
Overview
The node integrates with the Bitrix24 platform, specifically allowing interaction with its CRM and business services. The "Update User" operation under the "User" resource enables updating details of a specified user in Bitrix24 by sending new user data.
This node is beneficial when automating user management workflows within Bitrix24, such as synchronizing user information from external systems, updating user profiles programmatically, or managing user attributes during onboarding/offboarding processes.
Practical example:
- Automatically update a user's contact information or role after receiving updated data from an HR system.
- Modify user permissions or profile fields based on changes in organizational structure.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method to authenticate with Bitrix24: OAuth2 (recommended), Webhook URL (simpler but less secure), or API Key authentication. |
| User ID | The unique identifier of the user to update. |
| User Data | JSON object containing the user fields and values to update. |
| Options | Additional optional parameters: |
| - Filter | JSON filter criteria (not typically used for update but available). |
| - Order | JSON sort criteria (not typically used for update but available). |
| - Admin Mode | Boolean flag indicating whether to perform the operation in admin mode. |
| - Custom Parameters | JSON object for any extra parameters to include in the request. |
| - Access Token | Optional access token string for authentication override. |
Output
The node outputs an array of items where each item contains a json property representing the response from Bitrix24 after attempting to update the user. This typically includes confirmation of the update or error details if the update failed.
If the operation fails and "Continue On Fail" is enabled, the output will contain an error object with keys:
error: Error message string.resource: The resource name ("user").timestamp: ISO timestamp of the error occurrence.
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 to perform user updates.
- Proper configuration of credentials in n8n is necessary to authorize API calls.
- No additional external libraries beyond those bundled are required.
Troubleshooting
Common issues:
- Invalid or expired authentication tokens leading to authorization errors.
- Incorrect or missing User ID causing the update to fail.
- Malformed JSON in the "User Data" property resulting in API rejection.
- Insufficient permissions if not using admin mode for certain user fields.
Error messages:
- Authorization errors: Check that the selected authentication method is correctly configured and tokens are valid.
- Validation errors from Bitrix24 API: Verify the user ID exists and the JSON data matches expected field formats.
- Network or connectivity errors: Ensure n8n can reach Bitrix24 endpoints and no firewall blocks exist.
Resolutions:
- Refresh or reconfigure authentication credentials.
- Validate input data before execution.
- Enable admin mode if higher privileges are needed.
- Use the "Continue On Fail" option to handle errors gracefully in workflows.