Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform
Join our community

Actions290

Overview

The node integrates with the Bitrix24 platform, specifically allowing users to update tasks within Bitrix24. It supports multiple authentication methods including OAuth2, webhook URLs, and API keys, making it flexible for different security and deployment scenarios.

This node is beneficial in automation workflows where task management in Bitrix24 needs to be programmatically controlled or updated based on external triggers or data changes. For example, you can automatically update a task's status, deadline, or responsible user when certain conditions are met in your workflow, ensuring that your team’s task tracking stays synchronized with other systems.

Practical examples:

  • Automatically updating the deadline of a task when a related project milestone date changes.
  • Changing the responsible user of a task when a team member leaves or is reassigned.
  • Adjusting task priority or status based on incoming customer support tickets or CRM updates.

Properties

Name Meaning
Authentication Method used to authenticate with Bitrix24. Options: OAuth2 (recommended for production), Webhook (simpler but less secure), API Key.
Task ID The unique identifier of the task to update. This is required to specify which task will be modified.
Fields Collection of fields to update on the task. Possible fields include:
- Title: Title of the task
- Description: Detailed description
- Responsible User ID: User assigned to the task
- Deadline: Task deadline date/time
- Priority: Low, Normal, High
- Status: New, Pending, In Progress, Supposedly Completed, Completed, Deferred, Declined
- Group ID: Group associated with the task
- Created By: User who created the task
- Start Date: Planned start date/time
- End Date: Planned end date/time
Options Additional optional parameters as JSON objects:
- Filter: Criteria to filter tasks (JSON format)
- Order: Sorting order (JSON format)
- Select: Fields to select (JSON array)
- Group: Grouping criteria (JSON format)
- Custom Parameters: Any extra parameters (JSON format)

Output

The node outputs an array of items where each item contains a json object representing the response from Bitrix24 after attempting to update the specified task. The structure typically includes the updated task details or error information if the update failed.

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

No binary data output is indicated by the source code.

Dependencies

  • Requires connection to Bitrix24 via one of the supported authentication methods (OAuth2, webhook URL, or API key).
  • The node depends on Bitrix24 API endpoints to perform task updates.
  • Proper credentials must be configured in n8n for the chosen authentication method.
  • No additional external libraries beyond those bundled with the node are required.

Troubleshooting

  • Common issues:

    • Invalid or expired authentication credentials leading to authorization errors.
    • Incorrect or missing Task ID causing the update to fail because the target task cannot be found.
    • Providing invalid field values or unsupported field formats may cause API errors.
    • Network connectivity issues preventing communication with Bitrix24 API.

  • Error messages:

    • Errors returned from Bitrix24 API will be included in the output JSON under the error property if "Continue On Fail" is enabled.
    • Common error messages might include authentication failures, permission denied, invalid task ID, or malformed request payloads.

  • Resolutions:

    • Verify and refresh authentication credentials.
    • Ensure the Task ID exists and is correct.
    • Validate field values against Bitrix24 API documentation.
    • Check network connectivity and firewall settings.

Links and References

Discussion