post https://api.dengage.com/rest/bulk/async/contacts
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.