Upload files

Upload a file or a group of files of the same type (invoice, deliveryNote... or one of your custom types) to your environment. Each file is then processed asynchronously. Allowed formats are - images: .jpeg, .jpg, .png, .tiff - PDFs: .pdf - Compressed files: .zip One of the parameters files or urls must be provided and can also be combined.

Authentication

x-api-keystring

API key authentication for programmatic access. Used by server-to-server integrations and API clients.

OR
x-access-tokenstring

Access token authentication for web users. Used by browser-based applications and authenticated user sessions.

Request

Upload files with optional URLs and metadata
filesfilesOptional

Files to upload (PDF or image)

urlslist of stringsOptionalDeprecated

DEPRECATED: Use the /v1/ingest/by-url endpoint instead for URL-based uploads.

Array of URLs from which files will be downloaded and processed. This field is maintained for backward compatibility but should not be used in new integrations.

infoobjectOptional
Information to map to the uploaded files in JSON format

Response

URL to upload created
accountIdstring
Account ID that the files were uploaded to
environmentIdstring
Environment ID that the files were uploaded to
importIdstring
Import ID that was registered
fileslist of objects
Array of uploaded files information

Errors