Actions31
- Company Actions
- Contact Actions
- Deal Actions
- Item Actions
- Lead Actions
- User Custom Method Actions
Overview
This node integrates with the Bitrix24 REST API to create new Deal records in a Bitrix24 CRM system. It is useful for automating the creation of sales deals based on data from other systems or workflows, such as when a new lead is qualified or an opportunity arises. For example, you could use this node to automatically add a deal when a form is submitted on your website or when a customer reaches a certain stage in your sales funnel.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method used to authenticate with Bitrix24: either OAuth2 or Webhook authentication. |
| Input Type | How to provide the input data for the deal creation: "Using Fields" (fill individual fields) or "Using JSON" (provide raw JSON data). |
| Fields | When using "Using Fields" input type, specify one or more field name-value pairs to set on the new deal. The field names can be selected from available Bitrix24 deal fields. |
| JSON Body | When using "Using JSON" input type, provide the complete JSON object representing the deal data. |
Output
The node outputs the response from the Bitrix24 API after creating the deal. This typically includes the newly created deal's ID and any other metadata returned by the API. The output is structured as JSON data under the json property of each item. There is no indication that binary data is produced by this node.
Dependencies
- Requires access to a Bitrix24 account with appropriate permissions to create deals.
- Requires configuration of authentication credentials in n8n, either via OAuth2 or Webhook authentication methods.
- Uses Bitrix24 REST API endpoints for deal management.
Troubleshooting
- Authentication errors: Ensure that the provided API credentials are valid and have sufficient permissions to create deals.
- Invalid field names or values: When using the "Using Fields" input type, verify that the field names correspond exactly to those supported by Bitrix24. Using incorrect or unsupported fields may cause API errors.
- Malformed JSON: When using the "Using JSON" input type, ensure the JSON body is correctly formatted and contains all required fields for deal creation.
- API rate limits or connectivity issues: Network problems or Bitrix24 API rate limiting may cause failures; retry or check API status if errors occur.
Links and References
- Bitrix24 REST API Documentation
- n8n Expressions Documentation (for dynamic field value expressions)