English
Create Sales Record Object
About 302 wordsAbout 1 min
2026-01-19
Description
Create a sales record object
Request Specification
HTTP Method: POST + application/json
Request Path: https://${cloud domain}/cgi/crm/v2/data/create?thirdTraceId=${Random String}
Request Headers: Refer to Common Parameters
Request Parameters
For detailed field descriptions, please refer to Parameter Specification
| Parameter | Type | Required | Description |
|---|---|---|---|
| triggerApprovalFlow | Boolean | No | Whether to trigger approval flow (defaults to true when not provided, meaning triggered). This parameter applies to all objects. |
| triggerWorkFlow | Boolean | No | Whether to trigger workflow (defaults to true when not provided, meaning triggered). This parameter applies to all objects. |
| hasSpecifyTime | Boolean | No | Whether creation time can be specified (defaults to false when not provided, meaning the create_time field in parameters will be ignored) |
| hasSpecifyCreatedBy | Boolean | No | Creator (defaults to false when not provided, meaning the created_by field in parameters will be ignored) |
| includeDetailIds | Boolean | No | Whether to include sub-objects (when creating master-sub objects together, whether to return sub-object ID list. true returns, false doesn't, defaults to not returning) |
| data | Map | Yes | Data Map |
Request Example
{
"triggerApprovalFlow": true,
"triggerWorkFlow": true,
"hasSpecifyTime": true,
"hasSpecifyCreatedBy": true,
"includeDetailIds": true,
"data": {
"object_data": {
"dataObjectApiName": "ActiveRecordObj",
"object_describe_api_name": "hello",
"name": "hello"
},
"optionInfo": {
"skipFuncValidate": true,
"isDuplicateSearch": true,
"useValidationRule": true
},
"details": {
"detail_api_name": {}
}
}
}Response Parameters
| Parameter | Type | Description |
|---|---|---|
| traceId | string | Unique request ID |
| errorDescription | string | Error description |
| dataId | String | Data ID |
| errorMessage | string | Error message |
| errorCode | Int | View error codes |
Response Example
{
"traceId": "E-O.827xxxxxx",
"errorDescription": "success",
"dataId": "68faxxxxxx",
"errorMessage": "OK",
"errorCode": 0
}Notes
- Do not use the message field in the response for logical judgment as errorMessage may change;
- Special fields follow these specifications: | Field apiName | Request Type | Required | Remarks | | :----------- | :----------: | :------: | :------ | | related_object | | No | Do not pass this parameter | | related_api_names | | No | Do not pass this parameter | | related_object_data | List<Map<String,Object>> | Yes | Associated object data |
