English
Create Opportunity Object
About 240 wordsLess than 1 minute
2026-01-19
Description
Create an opportunity object.
Request Specification
Method: POST + application/json
Endpoint: https://${Enter your cloud domain}/cgi/crm/v2/data/create?thirdTraceId=${Random String}
Headers: Refer to Common Parameters
Request Parameters
For detailed field descriptions, see Parameter Configuration Guide
| Parameter | Type | Required | Description |
|---|---|---|---|
| triggerApprovalFlow | Boolean | No | Whether to trigger approval flow (defaults to true when not provided; applies to all objects) |
| triggerWorkFlow | Boolean | No | Whether to trigger workflow (defaults to true when not provided; applies to all objects) |
| hasSpecifyTime | Boolean | No | Whether creation time can be specified (defaults to false when not provided; ignores create_time in parameters) |
| hasSpecifyCreatedBy | Boolean | No | Creator (defaults to false when not provided; ignores created_by in parameters) |
| includeDetailIds | Boolean | No | Whether to include master-detail objects (when creating master and detail together, whether to return detail object IDs; true returns, false does not; default false) |
| data | Map | Yes | Data map |
Request Example
{
"triggerApprovalFlow": true,
"triggerWorkFlow": true,
"hasSpecifyTime": true,
"hasSpecifyCreatedBy": true,
"includeDetailIds": true,
"data": {
"object_data": {
"dataObjectApiName": "OpportunityObj",
"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
messagefield in responses for logical judgments, aserrorMessagemay change;
