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
API key authentication for programmatic access. Used by server-to-server integrations and API clients.
Access token authentication for web users. Used by browser-based applications and authenticated user sessions.
Request
Binary files to upload via multipart/form-data.
Supported formats:
- Images: .jpeg, .jpg, .png, .tiff
- PDFs: .pdf
- Compressed files: .zip (for bulk uploads)
Note: Upload actual binary file data, not file paths or strings. Use standard HTML file input or equivalent HTTP multipart upload.
Filename Encoding Limitation: Due to RFC 2388 multipart/form-data specification, filenames are limited to Latin-1 (ISO-8859-1) character encoding. Non-ASCII characters (e.g., UTF-8 Unicode) in filenames will appear corrupted. For best compatibility, use ASCII-safe characters in filenames or implement client-side filename encoding.
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.