Actions20
Deal → Create
AI-generatedOverview
This node allows users to create custom user fields for Deals in Bitrix24 CRM. It is useful for extending the default data structure of Deals by adding new fields tailored to specific business needs, such as custom text fields, enumerations, dates, or files. For example, a user can create a custom field to track a special deal attribute not available by default in Bitrix24.
Use Case Examples
- Creating a custom text field named 'Custom Deal Code' to store unique deal identifiers.
- Adding an enumeration field to categorize deals by priority levels.
Properties
| Name | Meaning |
|---|---|
| Field Name | The internal identifier for the custom field (e.g., UF_CRM_CUSTOM_FIELD). This is required to uniquely identify the field in Bitrix24. |
| Field Label | The display label for the custom field shown in the Bitrix24 UI. |
| Field Type | The data type of the custom field, such as string, integer, boolean, enumeration, date, datetime, file, money, or URL. |
| List Values | A collection of predefined values for enumeration type fields. Each value represents an option in the dropdown list. |
| Multiple | Indicates if the field supports multiple values (true) or a single value (false). |
| Mandatory | Indicates if the field is required (true) or optional (false). |
| Show Filter | Determines if the field should be available as a filter in the UI (true or false). |
| Show In List | Determines if the field should be visible in list views (true or false). |
Output
JSON
result- The response from Bitrix24 API after creating the user field, typically including the new field's ID and status.
Dependencies
- Bitrix24 API with appropriate credentials
Troubleshooting
- Ensure the Field Name is unique and follows Bitrix24 naming conventions (e.g., starts with UF_CRM_).
- Verify that the API credentials have permissions to create user fields in Bitrix24.
- If creating an enumeration field, ensure that List Values are provided and correctly formatted.
- Common errors include invalid field types or missing required parameters; check the error message for details and correct the input accordingly.
Links
- Bitrix24 User Fields API Documentation - Official Bitrix24 documentation for managing user fields via API.