Bulk create records
Submit up to 1,000 records for asynchronous processing. Returns immediately with a bulk request ID. Each record is validated and inserted independently, so some records can succeed while others fail. Use the GET /bulk_requests/{id} endpoint to poll for results.
Authorizations
Headers
Optional idempotency key. If a bulk request with this key already exists for your environment, the existing request is returned instead of creating a new one.
Body
1 - 1000 elementsHow to handle records whose external_id already exists in the target stream. skip (default) silently skips duplicates and counts them in skipped_items. error surfaces duplicates as per-row failures. Only applies to records with external_id set.
skip, error Response
Bulk request accepted for processing
Summary returned when a bulk request is created or retrieved via idempotency key
Unique identifier for the bulk request
Current processing status
pending, processing, completed, failed, cancelled Number of records submitted
Number of records processed so far
Number of records successfully created
Number of records that failed
Number of records skipped due to on_conflict: skip matching an existing external_id
Polling URL to check progress (e.g. /v1/bulk_requests/123)