CreateDataExtensionJob
Initiates an asynchronous process to insert or upsert data into a data extension in Salesforce Marketing Cloud. It supports operations by key or identifier (Id) and returns job details for tracking and performance monitoring.
Input
| Name | Type | Required | Description |
| DataExtensionId | String | False | Specifies the unique identifier (Id) of the data extension where rows are to be inserted or upserted. This system-generated value determines the target data extension for the asynchronous operation and ensures that the correct structure and field mapping are applied during execution. |
| CustomerKey | String | False | Specifies the customer-defined key that uniquely identifies the data extension in API operations. This key provides a stable reference across environments and can be used instead of the system-generated Id when initiating or automating insert and upsert operations. |
| RowsAggregate | String | False | Contains a JSON-formatted aggregate that defines the rows to be inserted or upserted into the target data extension. Each row includes field names and corresponding values that comply with the schema of the specified data extension. This parameter supports bulk operations and asynchronous job submission. |
| Mode | String | False | Specifies the operation mode that determines how data is written to the target data extension.
The allowed values are INSERT, UPSERT. The default value is INSERT. |
Result Set Columns
| Name | Type | Description |
| RequestId | String | Returns the unique identifier (Id) of the successfully queued asynchronous request. This Id is used in subsequent operations to retrieve the current status or results of the operation. |