Skip to main content
POST
/
api
/
vendor
/
payroll
/
documents
Create vendor payroll document upload
curl --request POST \
  --url https://api.sandbox.bitwage.com/api/vendor/payroll/documents \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "company_id": "<string>",
  "filename": "invoice-1001.pdf"
}
'
{
  "invoice_upload_id": "<string>",
  "upload_url": "<string>",
  "headers": {},
  "temp_s3_key": "<string>",
  "expires_at": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://developer.bitwage.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key authentication. Include your access token as: Authorization: Basic <ACCESS_TOKEN>

Headers

​
Idempotency-Key
string
required

Unique key for idempotent write requests.

Body

application/json
​
company_id
string
required

Company ID that the vendor document is being uploaded for.

​
filename
string
required

Original invoice file name.

Example:

"invoice-1001.pdf"

​
content_type
enum<string>
required

MIME type for the invoice file. Only PDF uploads are supported.

Available options:
application/pdf

Response

200 - application/json

Vendor payroll document upload session created.

​
invoice_upload_id
string

Upload ID to pass on the vendor payroll payment item.

​
upload_url
string<uri>

Presigned URL for uploading the invoice file.

​
headers
object

Headers to include when uploading the file.

​
temp_s3_key
string

Temporary object key for the uploaded invoice.

​
expires_at
string<date-time>

Time when the upload session expires.