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 Bitrix24 node integrates with the Bitrix24 CRM and business platform, enabling automation workflows to interact with various Bitrix24 resources. Specifically, the Task - Complete operation allows users to mark tasks as completed within their Bitrix24 environment.
This node is beneficial in scenarios such as:
- Automating task management by marking tasks complete based on external triggers or conditions.
- Synchronizing task statuses between Bitrix24 and other systems.
- Streamlining project workflows by programmatically updating task progress.
For example, a user could set up an automation that completes a Bitrix24 task when a related issue in another system is resolved, ensuring consistent status updates across platforms.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating with Bitrix24: OAuth2 (recommended), Webhook (simpler but less secure), or API Key authentication. |
| Options | Collection of optional parameters to customize the request: |
| Filter | JSON object specifying filter criteria for selecting tasks. |
| Order | JSON object defining the sort order of results. |
| Select | JSON array listing specific fields to retrieve. |
| Group | JSON object defining grouping criteria. |
| Custom Parameters | Additional custom parameters in JSON format to include in the API call. |
| Access Token | String containing an access token for authentication (if applicable). |
Output
The node outputs an array of items where each item contains a json property representing the response from Bitrix24 after attempting to complete the specified task(s).
- The
jsonoutput typically includes details about the completed task or confirmation of the completion action. - If an error occurs and "Continue On Fail" is enabled, the output will contain an
errorfield with the error message, along with metadata such as the resource name and timestamp. - The node does not explicitly output binary data.
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 operations.
- No additional external services are required beyond Bitrix24 itself.
- Proper configuration of authentication credentials in n8n is necessary for successful API calls.
Troubleshooting
Common Issues:
- Invalid or expired authentication tokens leading to authorization errors.
- Incorrectly formatted JSON in options like Filter, Order, Select, Group, or Custom Parameters causing API request failures.
- Network connectivity issues preventing communication with Bitrix24 API.
Error Messages:
- Errors returned from Bitrix24 API will be surfaced in the node's output if "Continue On Fail" is enabled.
- Typical errors include authentication failures, permission denials, or invalid parameter formats.
Resolutions:
- Verify and refresh authentication credentials.
- Validate JSON syntax in all input properties before execution.
- Ensure the Bitrix24 account has sufficient permissions to complete tasks.
- Check network connectivity and firewall settings.