Imports a batch of Insight data records into a collection and upserts them. This either creates new records or updates already existing records. This is an asynchronous operation and you need to check when it is complete by calling getImportStatus
Notes:
- If the Insight data collection does not exist it will be created
- If targeting a contact scoped Insight collection, then you must provide a contactIdentity on each record
Bulk data upload calling pattern
The most efficient pattern is to pass your data to us in the fewest calls. To achieve this it is important to batch your data within your system and then send it to us. You can send a request up to 50MB, so many records can be sent in a single call.
You can perform multiple bulk imports at a time for an account. Typically we'd suggest 5 as a maximum, for optimal speed and performance. You should then poll periodically (recommend every 5-30 seconds) to check on the status of your bulk import using the retrieve Insight data import status call passing the import ID the bulk import Insight data returned. When imports complete you can then continue to add more data.
Ensure contacts already exist to successfully bulk add transactional data to them
You need to ensure that the contacts you're bulk adding transactional data to already exist in the account. Contacts aren't created in this operation.
You can import a max of 50MB of data per call and a max of 5 concurrent imports
Your JSON request body can be a maximum size of 50MB, therefore allowing a large number of records to be imported in a single call. You can run up to 5 concurrent bulk imports.