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
This node integrates with the Bitrix24 platform, specifically allowing users to add new users to their Bitrix24 account. It supports multiple authentication methods including OAuth2, webhook URLs, and API keys, making it flexible for different security and deployment scenarios.
Typical use cases include automating user management workflows such as onboarding new employees, synchronizing user data from other systems, or programmatically managing access within Bitrix24. For example, a company could automatically add new hires to Bitrix24 CRM when they are added to an HR system.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating with Bitrix24: OAuth2 (recommended), Webhook (simpler but less secure), or API Key. |
| User Data | JSON object containing the details of the user to be added. This includes all relevant user fields as per Bitrix24's API. |
| Options | Additional optional parameters: - Filter: JSON criteria to filter data (not typically used in Add User). - Order: JSON defining sort order. - Admin Mode: Boolean flag to perform operation with admin privileges. - Custom Parameters: Extra JSON parameters to customize the request. - Access Token: String token for authentication override. |
Output
The node outputs an array of items where each item contains a json field representing the response from Bitrix24 after attempting to add the user. The structure typically includes:
- Confirmation of the created user with their assigned ID and details.
- In case of failure (if "Continue On Fail" is enabled), an error object with message, resource type, and timestamp.
No binary data output is produced by this node.
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 endpoints to perform operations.
- No additional external dependencies beyond standard HTTP requests to Bitrix24 services.
- Proper configuration of credentials in n8n is necessary for successful execution.
Troubleshooting
- Authentication Errors: Ensure that the selected authentication method is correctly configured with valid tokens or keys. OAuth2 requires proper token refresh setup.
- Invalid User Data: The JSON provided in "User Data" must conform to Bitrix24's expected schema. Invalid or missing required fields will cause API errors.
- Permission Issues: If not using admin mode, some user creation actions might be restricted. Enable "Admin Mode" if higher privileges are needed.
- API Rate Limits: Bitrix24 may throttle requests; handle rate limiting by adding delays or retries.
- Error Messages: When errors occur, the node returns an error message in the output JSON. Review the message for clues, such as invalid parameters or authentication failures.