---
title: "Upload attachment"
method: POST
path: "/v2/attachments"
tags: ["Attachments"]
---

# Upload attachment

`POST /v2/attachments`

OAuth scope: `attachment.write`

---

Upload an attachment

---

This endpoint allows you to upload an attachment to be then linked to an external transfer. Valid files are: JPEG, PNG and PDFs. The endpoint is particularly useful when you want to link an attachment to an external transfer via [POST /v2/external_transfers](https://api-doc.qonto.com/docs/business-api/b3A6MjM2NDE0OTk-create-an-external-transfer) and [POST /v2/external_transfers/checkout](https://api-doc.qonto.com/docs/business-api/b3A6MzAxODAwMDI-create-external-transfers-with-creditor-data).

Inside Qonto, attachments are files uploaded onto transactions by users. Attachments typically correspond to the *invoice* or *receipt*, and are used to justify the transactions from a bookkeeping standpoint.

## Headers

- `X-Qonto-Idempotency-Key` string, uuid
- `X-Qonto-Staging-Token` string

## Response `200`

returns an attachment ID

- object
  - `attachment` object
    - `id` string

## Other responses

- `400` — returns a bad request error
- `403` — returns a forbidden error

---

[API](https://skmtc.net/hiit-consulting-fr/apis/qonto.md) · [All operations](https://skmtc.net/hiit-consulting-fr/apis/qonto/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hiit-consulting-fr/qonto/versions/25208d6f9deb/schema)