Create upload targets for one or more CSV files
Create an import row per file and return a presigned S3 POST target for each. Check uploadMode for how to deliver the file. Prefer POST /imports/initiate for a single file. userId is required and non-empty with an API key and ignored for signed-in sessions, which record the authenticated user.
Authorization
Headers
Release date, as YYYY-MM-DD. Defaults to 2026-10-06.
Target organization id (Organization-Id selector).
Target connection id; resolves to its organization.
Platform entity id; resolves to a connection's organization.
Optional source to disambiguate an Entity-Id.
Body
Files to create upload targets for.
Import source the files belong to.
Required and non-empty when authenticating with an API key: the id of the person or process performing the upload, recorded for audit. Ignored for signed-in sessions, which record the authenticated user.
SALE or PURCHASE for the whole file; blank per-row direction cells take this value.
SALEPURCHASEResponse
Name of the file this target is for.
Id of the import row created for this file.
Where to upload the file: a presigned S3 POST URL, or a path on this API when uploadMode is local_internal.
Additional form fields required on the upload POST.
How to deliver the file. presigned sends it to the returned URL directly. local_internal only appears in local development: send it to the returned path on this API with your credential.
presignedlocal_internalSuccessful Response
The request was invalid.
Authentication failed or was missing.
The credential is not permitted for this request.
The requested resource was not found.
The request conflicts with existing state.
The request failed validation.