---
title: "Upload a recipient attachment"
method: POST
path: "/recipient/{recipientId}/attachments"
tags: ["Recipients"]
---

# Upload a recipient attachment

`POST /recipient/{recipientId}/attachments`

Upload a tax form attachment for a recipient. The file is uploaded via multipart/form-data. Supported file types include PDF, images (PNG, JPG, GIF), and common document formats. The attachment will be associated as a tax document for the recipient.

## Path parameters

- `recipientId` string, uuid, required

## Response `200`

Successfully uploaded attachment. Returns attachmentId and downloadUrl.

## Other responses

- `400` — Bad request. Either no file was uploaded or the filename exceeds the 299 character limit.
- `404` — Recipient not found
- `413` — File too large. Maximum file size is 32MB.
- `415` — Unsupported file type. Potentially dangerous file extensions (e.g., .exe, .bat) are not allowed.

---

[API](https://skmtc.net/mercurytechnologies/apis/mercury-api.md) · [All operations](https://skmtc.net/mercurytechnologies/apis/mercury-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mercurytechnologies/mercury-api/revisions/0bdf4a496e03/schema)