Skip to main content
POST
Create document upload

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Content-Type
string

Content-Type must be set to application/json.

Path Parameters

businessId
string<uuid>
required

The UUID of the business to create the document for.

Body

application/json

Parameters for creating a new document with presigned upload URLs.

document_type
enum<string>
required

The type of document being uploaded.

Available options:
RECEIPT,
UNSTRUCTURED_BOOKKEEPING_CONTEXT,
OTHER
file_name
string
required

The name of the file including its extension.

Example:

"quarterly-report.pdf"

file_type
string
required

The MIME type of the file.

Example:

"application/pdf"

file_size_bytes
integer<int64>
required

The size of the file in bytes. Used to calculate the number of upload parts.

Example:

10485760

Response

Document record created and multipart upload initiated. The response includes presigned URLs for uploading file parts.

data
object
required

Response containing presigned URLs for multipart upload to S3.