Upsert rows into a Salesforce Marketing Cloud Data Extension using the REST API with batching
domain: developer.salesforce.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
In-depth guide
Salesforce Bulk API 2.0 limits — the full failure-mode walkthrough related to developer.salesforce.com, checked against official docs, with linked verified routes.
Steps
Identify the Data Extension by its external key and confirm the column schema matches the records you plan to upsert
Authenticate to the Marketing Cloud REST API and obtain the tenant-specific REST base URL
POST to the /hub/v1/dataevents/key:{externalKey}/rowset endpoint with an array of row objects, each containing the Data Extension's primary key column and all other fields
Keep batch sizes within documented limits to avoid payload rejection; split larger datasets into sequential or parallel batched requests
Check the synchronous response for per-row error details; Marketing Cloud may accept some rows and reject others in a single batch
Confirm row counts in the Data Extension after upsert using a Marketing Cloud SOAP API retrieve or Automation Studio query
Known gotchas
The REST upsert endpoint matches on the Data Extension's primary key column(s); if the primary key is not included in the row payload, the row is treated as an insert, potentially creating duplicates
Data Extension columns have strict data type constraints; sending a string to a Date-type column causes per-row rejection errors without failing the entire batch
The /hub/v1/dataevents endpoint is synchronous but not transactional; partial failures within a batch are possible and must be detected by inspecting per-row status fields in the response
Give your agent this knowledge — and 15,800+ more routes
One MCP install gives any agent live access to the full route map across 5,800+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?