---
title: "Upload File Document"
method: POST
path: "/transactions/{transactionId}/documents/file"
tags: ["Forms and Documents"]
---

# Upload File Document

`POST /transactions/{transactionId}/documents/file`

## Request

- Base URL: `https://ws.zipformplus.com/api`
- URL: `https://ws.zipformplus.com/api/transactions/{transactionId}/documents/file`
- Auth: API key in header `X-Auth-ContextId`

Uploads a file document to a transaction. If `Id` is omitted, a new document is created at version 1. If `Id` is provided and matches an existing document, a new version is added.

**Supported MIME types:** `application/pdf`, `application/msword`, `application/vnd.openxmlformats-officedocument.wordprocessingml.document`, `application/vnd.ms-excel`, `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`, `image/jpeg`, `image/png`, `image/bmp`, `image/gif`

## Query parameters

- `Name` string, required
- `Description` string, required
- `ContainerId` string
- `Id` string

## Response `201`

Document uploaded. Returns the endpoint URL for the uploaded document.

## Other responses

- `401`: Unauthorized
- `404`: Document ID provided but not found
- `415`: Unsupported media type

---

[API](https://skmtc.dev/lwolf/apis/zipform-partner-api.md) · [All operations](https://skmtc.dev/lwolf/apis/zipform-partner-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lwolf/apis/zipform-partner-api/revisions/89796ac90fc6?raw)