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
files
Files to upload (PDF or image)
urlsDeprecated
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.
info
Information to map to the uploaded files in JSON format
Response
URL to upload created
accountId
Account ID that the files were uploaded to
environmentId
Environment ID that the files were uploaded to
importId
Import ID that was registered
files
Array of uploaded files information