PUT /hub/v1/dataevents/key:{key}/rows/{primaryKeys}

Upserts a data extension row by data extension external key or ID. An upsert operation updates rows when the specified key already exists and inserts new rows when the specified key doesn't exist.

To upsert multiple data extension rows in a single operation, use the POST method instead.

NameTypeDescription
keystringRequiredThe data extension external key, which is included in the URL as key:{keyValue}. If you don’t provide an ID, you must provide an external key.
idstringRequiredThe data extension ID, which is included in the URL. If you don’t provide an external key, you must provide an ID.
primaryKeysarrayThe key-value pair of the primary key for the row.
NameTypeDescription
valuesobjectThe column name and value dataset for the row that you want to insert into the data extension.

Example Request

Or

Example Response

If your request is invalid, the API returns a 400 response. This response includes additional details about the error.