j
Data Extension Rows Synchronous API
1
To modify individual rows or groups of rows (rowsets) in a data extension, use the /hub/v1/dataevents/ endpoints. Requests that you send to these endpoints are executed synchronously.
NOTE
There are several APIs related to data extensions:
- Use this API or the Data Extension Rows (Asynchronous) API to add or update rows of data in a data extension.
- Use the Data Extensions API to create, modify, and manage data extension objects.
- Use the Data Extension Data API to query data in a data extension.
- Use the Data Extension Imports API to manage data import jobs.
This table lists the use cases that the Data Extension Rows Synchronous API supports.
| Use Case | HTTP Verb | Endpoint |
|---|---|---|
| Upsert a row | PUT | /hub/v1/dataevents/{dataExtensionId}/rows/{primaryKey}:{PrimaryKeyValue} |
| Upsert a row by data extension external key | PUT | /hub/v1/dataevents/key:{externalKey}/rows/{primaryKey}:{PrimaryKeyValue} |
| Increment column value | PUT | /hub/v1/dataevents/{dataExtensionId}/rows/{primaryKey}:{primaryKeyValue}/column/{column}/increment |
| Increment column value by data extension external key | PUT | /hub/v1/dataevents/key:{externalKey}/rows/{primaryKey}:{primaryKeyValue}/column/{column}/increment |
| Upsert a rowset by using a data extension ID | POST | /hub/v1/dataevents/{dataExtensionId}/rowset |
| Upsert a rowset by using a data extension external key | POST | /hub/v1/dataevents/key:{externalKey}/rowset |
Append the operation endpoint addresses to this base URL, replacing {subdomain} with the unique subdomain for your Marketing Cloud Engagement tenant:
https://{subdomain}.rest.marketingcloudapis.com
DID THIS ARTICLE SOLVE YOUR ISSUE?
Let us know so we can improve!
Let us know so we can improve!