Create Visitor Information Object
# Description
Create a visitor information object.
# Request Specification
Method: POST + application/json
Path: https://${Cloud Domain}/cgi/crm/v2/data/create?thirdTraceId=${Random String}
Headers: Refer to Common Parameters
# Request Parameters
For detailed field descriptions, refer to Parameter Specification.
| Parameter | Type | Required | Description |
|---|---|---|---|
| triggerApprovalFlow | Boolean | No | Whether to trigger approval flow (defaults to true if not provided, indicating triggering). This parameter applies to all objects. |
| triggerWorkFlow | Boolean | No | Whether to trigger workflow (defaults to true if not provided, indicating triggering). This parameter applies to all objects. |
| hasSpecifyTime | Boolean | No | Whether creation time can be specified (defaults to false if not provided, ignoring the create_time field in parameters). |
| hasSpecifyCreatedBy | Boolean | No | Creator (defaults to false if not provided, ignoring the created_by field in parameters). |
| includeDetailIds | Boolean | No | Whether to include detail objects (when creating master-detail objects together, whether to return detail object IDs. true: return, false: do not return, default: do not return). |
| data | Map | Yes | Data Map |
# Request Example
{
"triggerApprovalFlow": true,
"triggerWorkFlow": true,
"hasSpecifyTime": true,
"hasSpecifyCreatedBy": true,
"includeDetailIds": true,
"data": {
"object_data": {
"dataObjectApiName": "WebImVisitorObj",
"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 | 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.