Skip to main content
POST
Submit Import

Submit Import

Submit a validated import session for downstream processing. This creates the data file and starts the processing pipeline that will ingest the records into your organization’s data.
Submission is irreversible. Once submitted, the session cannot be modified or re-submitted. Make sure all row corrections are complete before submitting.

Request

Headers

string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa
string
required
Partner identifier for the submitting applicationExample: dcycle

Path Parameters

string
required
UUID of the import session to submitExample: "11111111-1111-1111-1111-111111111111"

Body Parameters

boolean
default:"false"
When true, submit even if some rows have validation errors. Only valid rows will be processed; error rows are skipped.
object
Additional context values collected late in the wizard (e.g. facility_id for wastes). Values are merged into the session before submission.Example: {"facility_id": "a8315ef3-dd50-43f8-b7ce-d839e68d51fa"}

Response

string
Submission result status (e.g. submitted)
string | null
UUID of the created data file
string | null
UUID of the downstream processing job. Use this to track processing progress.
integer
Number of rows submitted for processing

Example

Successful Response

Common Errors

401 Unauthorized

Cause: Missing or invalid API key

403 Forbidden

Cause: The authenticated user is not a member of the organization

400 Bad Request

Cause: Session has validation errors and ignore_errors is false

409 Conflict

Cause: Session has already been submitted

422 Unprocessable Entity

Cause: Missing required context field for the template

Get Import Status

Check submission and processing progress

Create Session

Start a new import