Actions24
Overview
This node integrates with the Bitrix24 CRM system to create new Lead records. It allows users to add leads either by specifying individual fields or by providing raw JSON data representing the lead. This flexibility makes it useful for automating lead capture from various sources, such as web forms, marketing platforms, or other CRMs, directly into Bitrix24.
Practical examples:
- Automatically creating a lead in Bitrix24 when a new contact fills out a web form.
- Importing bulk lead data from an external system by passing JSON arrays.
- Customizing lead creation by setting specific fields like name, phone, email, and status individually.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating with Bitrix24: OAuth2 or Webhook |
| Input Type | How to provide lead data: - Using Fields: Fill each field individually - Using JSON: Provide complete raw JSON data |
| Fields | When using "Using Fields" input type, specify one or more fields with their names/IDs and values |
| JSON Data | When using "Using JSON" input type, provide the full lead data as a JSON string |
Output
The node outputs an array of JSON objects representing the created lead(s). Each object corresponds to a lead record returned by the Bitrix24 API after creation. The structure typically includes the lead's ID and any other data returned by Bitrix24.
No binary data output is produced by this node.
Dependencies
- Requires valid authentication credentials for Bitrix24, either via OAuth2 or Webhook.
- Needs proper configuration of these credentials within n8n.
- Relies on Bitrix24 REST API availability.
Troubleshooting
- Invalid JSON in input data: Occurs if the JSON provided in the "JSON Data" property is malformed. Solution: Validate and correct the JSON format.
- Missing ID for update operation: Although not applicable for create, similar errors may appear if used incorrectly. Ensure required IDs are provided for update operations.
- Fields cannot be empty: When using "Using Fields" input type, at least one field must be specified.
- Unsupported operation: If an unsupported operation is selected, verify that only "Create" (add) is chosen for the Lead resource.
- API request failures: Could be due to invalid credentials, network issues, or Bitrix24 API limits. Check credentials and API status.
Links and References
- Bitrix24 REST API Documentation
- n8n Expressions Documentation (for dynamic field values)