---
title: "Upload a visual file"
description: "Uploads a file (image or PDF) to the account's storage as `multipart/form-data`."
canonical: "https://docs.printags.com/upload-a-visual-file/"
last_updated: "2026-11-16"
---

# Upload a visual file

`POST /v2/accounts/{accountId}/files`

Uploads a file (image or PDF) to the account's storage as `multipart/form-data`. The id of the stored file goes in `printingVisuals` when creating an order, or in `shippingFiles` for a document shipped with the order (a cover letter in PDF, for example).

## Authentication

An API key as a Bearer token: `Authorization: Bearer <key>`. A `sk_test_` key creates and sees test orders only. Keys and test mode: [overview](/).

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `accountId` | path | string | yes | Unique identifier of the account |

## Request body

Content type: `multipart/form-data`, required.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `file` | string (binary) | no | The file to upload |

## Responses

| Status | Description |
| --- | --- |
| 201 | File uploaded successfully |
| 400 | Bad request, invalid input |
| 401 | Unauthorized, authentication required, or an OAuth access token unknown, expired or revoked (`INVALID_TOKEN`) |
| 403 | The API key is inactive or revoked (`INACTIVE_API_KEY`), or targets another account (`ACCOUNT_ACCESS_DENIED`, refused once the account guard is enforced); with an OAuth access token: a token of scope `mcp` (`INSUFFICIENT_SCOPE`), a path naming another account or a person no longer a member of it (`ACCOUNT_ACCESS_DENIED`), a real token on the sandbox host (`SANDBOX_REQUIRES_TEST_KEY`) |
| 404 | Account not found |
| 429 |  |
| 500 | Internal server error |

## Example

```bash
curl -X POST "https://api.printags.com/v2/accounts/123e4567-e89b-12d3-a456-426614174000/files" \
  -H "Authorization: Bearer $PRINTAGS_API_KEY" \
  -F "file=@visual.png"
```
