Description

Create a mail object

Request Specification

Request Method: POST + application/json

Request Path: https://${Enter 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, default is false)
data	Map	Yes	Data Map

Request Example

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