Actions25
Overview
This node integrates with the Bitrix24 CRM system to manage "Deal" records. Specifically, the "Create" operation allows users to add new deals into their Bitrix24 account. This is useful in scenarios where you want to automate deal creation based on external triggers or workflows, such as when a new lead qualifies or an opportunity arises in another system.
Practical examples include:
- Automatically creating a sales deal when a form is submitted on a website.
- Creating deals from data collected in other applications like email marketing platforms or customer support tools.
- Integrating deal creation into multi-step automation workflows for sales pipeline management.
Properties
| Name | Meaning |
|---|---|
| Input Format | Choose how to provide the deal fields: either via a structured form input ("Form") or raw JSON ("JSON"). |
| Fields (JSON) | When using JSON input format, specify all deal fields as a JSON object. |
| Fields | When using Form input format, add one or more fields specifying the field name and its value. |
Details on "Fields" property (Form input):
- Field Name: Select the specific deal field to set.
- Field Value: Provide the value for the selected field. If the field supports enumerations, you can select from predefined options; otherwise, enter a string value.
Output
The node outputs an array of JSON objects representing the response from Bitrix24 after creating the deal(s). Each object typically contains details about the created deal, including its ID and any other returned metadata.
If multiple items are processed, the output will be an array of these responses corresponding to each input item.
Dependencies
- Requires a valid Bitrix24 API authentication token configured in n8n credentials.
- The node uses the Bitrix24 webhook URL to send API requests.
- Network access to the Bitrix24 API endpoint is necessary.
Troubleshooting
- Missing Credentials: Errors occur if the Bitrix24 API credentials or webhook URL are not set or invalid. Ensure credentials are properly configured.
- Invalid Field Names or Values: Providing incorrect field names or values not supported by Bitrix24 may cause errors. Use the "Load Options" feature to get valid field names and enumeration values.
- JSON Parsing Errors: When using JSON input format, ensure the JSON is well-formed and valid.
- API Errors: Bitrix24 API might return errors due to permissions, rate limits, or invalid data. Check error messages for guidance.
- Language Setting: The node sets a default language environment variable; if localization issues arise, verify the language configuration.
Links and References
- Bitrix24 REST API Documentation
- Bitrix24 CRM Deals API Reference
- n8n documentation on Creating Custom Nodes