---
title: "Create an attachment for an invoice"
method: POST
path: "/v1/finance/invoices/{invoiceId}/attachments"
tags: ["Invoices"]
---

# Create an attachment for an invoice

`POST /v1/finance/invoices/{invoiceId}/attachments`

## Request

- Base URL: `https://api.bigchange.com`
- URL: `https://api.bigchange.com/v1/finance/invoices/{invoiceId}/attachments`
- Auth: HTTP bearer

Creates a new attachment for an invoice (required scope attachments:write)

## Path parameters

- `invoiceId` integer, required

## Headers

- `Customer-Id` integer, required

## Request body `multipart/form-data`

- object
  - `file` string, binary, required: The file to upload

## Response `201`

Created

- PostResponseInt64: Represents a response for a POST request, containing the ID of the newly created record
  - `id` integer: Identifier of the newly created record

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Content
- `500`: Internal Server Error

## Changes

- **2026-11-17** `e98326ed0f00`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bigchange/apis/bigchange-dx/changes/v1/finance/invoices/:invoiceId/attachments/post.md)

---

[API](https://skmtc.dev/bigchange/apis/bigchange-dx.md) - [All operations](https://skmtc.dev/bigchange/apis/bigchange-dx/llms.txt) - [OpenAPI document](https://skmtc.dev/bigchange/apis/bigchange-dx/revisions/e98326ed0f00?raw)
