BulkUpsert-Async

This is the asynchronous version of the BulkUpsert API that allows inserting and updating contacts in the master_contact table. The operation is processed asynchronously and returns a job ID that can be used to track the status of the operation.

Key Features:

• Supports up to 1000 records per request
• Processes both new contact insertions and existing contact updates
• Asynchronous processing with job tracking
• Supports custom columns in addition to predefined ones
• Validates data against table structure

Important Notes:

• The contact_key column is mandatory and must be included in the columns array
• Each record in the request must include a valid contact_key
• Only columns that are marked as 'ImportEnabled' can be updated
• For multiple records with the same contact_key, only the last one in the list will be processed
• The operation returns a job ID (transactionId) that can be used to check the status via: GET https://api.dengage.com/rest/bulk/async/contacts/{jobId}
• The endpoint requires the DataSpace.Manage permission to upload contacts
• The job details endpoint requires the DataSpace.Read permission to view results

Response Codes:

• 202: Request accepted and processing started
• 400: Invalid request format or data validation failed (ResponseCodes: FieldError [1], ValidationFails [11])
• 401: Authentication required
• 403: Insufficient permissions (ResponseCodes: Forbidden [10])
• 429: Rate limit exceeded - too many concurrent requests
• 500: Unexpected server error (ResponseCodes: UnexpectedError [999])

Rate Limiting:

The endpoint implements concurrent request limiting to prevent system overload.