---
title: "Upload a settlement file to the secure URL"
method: PUT
path: "/{SettlementFileUploadUrl}"
tags: ["Settlements"]
---

# Upload a settlement file to the secure URL

`PUT /{SettlementFileUploadUrl}`

To send your CSV settlement file to Mangopay, use the `SettlementFileUploadUrl` value dynamically returned by [POST Create a Settlement and generate upload URL](/api-reference/settlements/create-settlement) endpoint.

<Warning icon="fa-regular fa-triangle-exclamation">
**Caution – Use settlement file example as template**

You must follow the [specifications provided here](/api-reference/settlements/settlement-file).

Use this <Download src="./Example_Mangopay_Settlement_File.csv">Example_Mangopay_Settlement_File.csv</Download>, which contains the correct column and row labels and example data for 3 transactions. Remove the example data lines before generating your own file.
</Warning>

You need to send one file per currency, as soon as it becomes available. Read more about [providing settlement files to Mangopay](/guides/echo#send-settlement-files-to-mangopay).

When calling the pre-signed `SettlementFileUploadUrl`:

* Ensure you integrate the full URL (host, path, queries) dynamically as it is unique to each file upload attempt
* Don't include the Authorization header, as the URL is already authenticated in the query strings
* Set the `Content-Type` header to `text/csv` and send the file as a raw binary stream using `data-binary`

Note that the `FileName` used by Mangopay is the one you sent on the [POST Create a Settlement and generate upload URL](/api-reference/settlements/create-settlement) endpoint (with a timestamp automatically appended); the name of the file on your system is only relevant for the `data-binary` stream in this call.

## Path parameters

- `SettlementFileUploadUrl` string, required

## Headers

- `Authorization` string, required

## Request body

- string, binary

## Response `200`

No response body. A 200 response indicates that the file was uploaded successfully.

- SettlementsUploadSettlementFileResponse200 — Empty response body

---

[API](https://skmtc.dev/mangopay/apis/api-reference.md) · [All operations](https://skmtc.dev/mangopay/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mangopay/api-reference/revisions/fafbd0c69654/schema)