Description

Create a lead 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, indicating triggering). This parameter applies to all objects.
triggerWorkFlow	Boolean	No	Whether to trigger workflow (defaults to true when not provided, indicating triggering). This parameter applies to all objects.
hasSpecifyTime	Boolean	No	Whether creation time can be specified (defaults to false when not provided, ignoring the create_time field in parameters)
hasSpecifyCreatedBy	Boolean	No	Creator (defaults to false when not provided, ignoring the created_by field in parameters)
includeDetailIds	Boolean	No	Whether to include sub-objects (when creating master-sub objects together, whether to return sub-object ID list. true: return, false: not return, default: not return)
data	Map	Yes	Data Map

Request Example

{
  "triggerApprovalFlow": true,
  "triggerWorkFlow": true,
  "hasSpecifyTime": true,
  "hasSpecifyCreatedBy": true,
  "includeDetailIds": true,
  "data": {
    "object_data": {
      "dataObjectApiName": "LeadsObj",
      "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;