---
title: "Create a Settlement and generate a secure URL for file upload"
method: POST
path: "/v3.0/{ClientId}/payins/intents/settlements"
tags: ["Settlements"]
---

# Create a Settlement and generate a secure URL for file upload

`POST /v3.0/{ClientId}/payins/intents/settlements`

Generate a pre-signed URL to which you can upload your Mangopay-format settlement file

This endpoint returns a unique temporary pre-signed URL, `SettlementFileUploadUrl`, that you can use to upload your Mangopay-format settlement file (see [PUT Upload a settlement file to the secure URL](/api-reference/settlements/upload-settlement-file)).

## Path parameters

- `ClientId` string, required

## Headers

- `Authorization` string, required

## Request body

- CreateASettlementAndGenerateASecureURLForFileUploadRequest
  - `FileName` string, required — The name of your file, which can be anything you wish. The file extension must be `.csv`.

## Response `200`

Success

- SettlementFileUploadResponse
  - `UploadUrl` string — The unique temporary pre-signed URL to which to upload your CSV file. Use the full dynamic URL including the host, path, and all query parameters. The URL is already authenticated, so the call does not require an Authorization header. See [PUT Upload a settlement file to the secure URL](/api-reference/settlements/upload-settlement-file) for details
  - `SettlementId` string — The unique identifier of the Settlement.

## Other responses

- `400` — Bad Request

---

[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)