j
Bulk Data Ingest API
v1
Create and manage bulk data ingest jobs to import large volumes of data without compromising performance.
To use this API, start by creating a bulk data ingest job. Next, format the data that you want to ingest in JSON format, with each row in the data extension represented as a JSON object. After that, send your data to API by staging it. Finally, complete data staging to add the job to the ingestion queue. When the job is complete, you can retrieve a summary of the job and the validation results.
This table lists the use cases that the Bulk Data Ingest API supports.
| Supported Use Case | HTTP Verb | URI |
|---|---|---|
| Create a bulk ingest job | POST | /data/v1/bulk/ingest |
| Get the job definition of a bulk data ingest job | GET | /data/v1/bulk/ingest/{bulkApiDefinitionId} |
| Update the job definition of an existing bulk data ingest job | PATCH | /data/v1/bulk/ingest/{bulkApiDefinitionId} |
| Delete the job definition of a bulk data ingest job | DELETE | /data/v1/bulk/ingest/{bulkApiDefinitionId} |
| Stage data for a bulk data ingest job | PUT | /data/v1/bulk/ingest/{bulkApiDefinitionId}/batches |
| Complete data staging | POST | /data/v1/bulk/ingest/{bulkApiDefinitionId}/batches/complete |
| Get bulk data ingest job summary | GET | /data/v1/bulk/ingest/{bulkApiDefinitionId}/summary |
| Get bulk data ingest job validation summary | GET | /data/v1/bulk/ingest/{bulkApiDefinitionId}/validation/summary |
| Get bulk data ingest job validation results | GET | /data/v1/bulk/ingest/{bulkApiDefinitionId}/validation/result |
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!