---
title: "Shipments uploads file"
method: POST
path: "/shipments/attachments/uploads/{id}"
tags: ["Shipments"]
---

# Shipments uploads file

`POST /shipments/attachments/uploads/{id}`

Uploads supporting documents to a specific shipment by its ID.
This method is used for attaching invoices, product specifications, customs declarations, or other shipment-related documents required for processing and clearance.
Files are stored and linked to the shipment, ensuring better traceability and compliance.

⚠️ Region restriction:</br>
This method is available only for European shipments (EU/EU and EU/UA directions).</br>
It is not available for shipments originating from Ukraine.

File naming:
• If the "fileName" parameter is provided, the uploaded file will be stored with that name.
• If "fileName" is not provided, the default file name will be set to "invoice".

Use cases:
1) "I want to upload a client invoice in PDF to shipment 980911" - send the base64-encoded content in "file", set `"fileName": "invoice.pdf"`.
2) "I want to attach a product photo in JPEG" - encode the photo in base64, set `"fileName": "product-photo.jpeg"`.

## Path parameters

- `id` integer, required

## Request body

- object
  - `file` string — Base64-encoded document file (PDF, JPEG, or other supported formats).
  - `fileName` string — Optional file name. Defaults to "invoice" if not provided.

## Response `201`

File upload result

- object
  - `success` boolean — Indicates whether the file upload was successful.

## Other responses

- `401` — Unauthorized
- `404` — The specified resource was not found
- `422` — Validation error
- `503` — Connection time-out

---

[API](https://skmtc.net/novapost/apis/api-nova-post.md) · [All operations](https://skmtc.net/novapost/apis/api-nova-post/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/novapost/api-nova-post/revisions/60e380005037/schema)