---
title: "Upload a new document"
method: POST
path: "/documents/"
tags: ["documents"]
---

# Upload a new document

`POST /documents/`

This endpoint is a simplified version of the upload document to inbox one - synchronous mode.

The upload file will be upload to the given inbox if provided, else fallback to the **invoice** inbox.
The file will be processed synchronously, ie the request will blocks until the document was processed
*or* until it timeout; in this case the document might **not** be correctly processed.


For a more reliable processing use the /documents/{inbox_id} endpoint in async mode


**Permission required:** upload

## Response `200`

Success

## Other responses

- `403` — Permission insufficient

---

[API](https://skmtc.net/contractp/apis/contract-p.md) · [All operations](https://skmtc.net/contractp/apis/contract-p/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/contractp/contract-p/versions/8ce53ebd6bd3/schema)