Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform

Actions89

Overview

This node integrates with the Bitrix24 platform, specifically enabling the creation of tasks within Bitrix24's task management system. It supports multiple authentication methods including OAuth2, webhook URLs, and API keys, allowing flexible and secure access to Bitrix24 APIs.

Typical use cases include automating task creation in Bitrix24 as part of business workflows, such as:

  • Creating follow-up tasks after a CRM deal is closed.
  • Automatically assigning tasks to team members based on external triggers.
  • Scheduling tasks with deadlines and priorities from other systems.

For example, a marketing automation workflow could create tasks for sales reps to follow up on leads generated by campaigns, setting responsible users, deadlines, and priorities dynamically.

Properties

Name Meaning
Authentication Method used to authenticate with Bitrix24. Options:
- OAuth2 (recommended for production)
- Webhook (simpler but less secure)
- API Key authentication
Fields Collection of fields defining the task details:
- Title: Title of the task
- Description: Detailed description
- Responsible User ID: User assigned to the task
- Deadline: Task deadline date/time
- Priority: Task priority (Low, Normal, High)
- Status: Task 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:
- Filter: JSON filter criteria
- Order: JSON sort order
- Select: JSON array of fields to select
- Group: JSON group criteria
- Custom Parameters: Extra JSON parameters
- Access Token: String token for authentication override

Output

The node outputs an array of items where each item contains a json object representing the response from Bitrix24 after creating the task. This typically includes the newly created task's data such as its ID and all set properties.

If an error occurs and "Continue On Fail" is enabled, the output will contain an item with an error field describing the issue, along with the resource name and a timestamp.

The node does not output binary data.

Dependencies

  • Requires connection to Bitrix24 API via one of the supported authentication methods (OAuth2, webhook URL, or API key).
  • The user must configure appropriate credentials in n8n for the chosen authentication method.
  • Network access to Bitrix24 endpoints is necessary.
  • No additional external libraries beyond those bundled with the node are required.

Troubleshooting

  • Authentication errors: Ensure that the selected authentication method is correctly configured with valid credentials or tokens. OAuth2 requires proper token setup; webhook URLs must be correct and active; API keys must have sufficient permissions.
  • API call failures: Could be due to invalid field values, missing required fields, or network issues. Verify that mandatory fields like "Title" are provided and correctly formatted.
  • Invalid JSON in options: The "Filter", "Order", "Select", "Group", and "Custom Parameters" fields expect valid JSON strings. Malformed JSON will cause errors.
  • Permission issues: The authenticated user must have rights to create tasks in the specified Bitrix24 account.
  • Error messages: If the node throws errors, check the message for clues. Common messages relate to authentication failure, invalid parameters, or API limits.

To resolve issues:

  • Double-check credentials and permissions.
  • Validate JSON inputs.
  • Review Bitrix24 API documentation for required fields and formats.
  • Enable "Continue On Fail" to capture error details in output for debugging.

Links and References

Discussion