# Create file

This method allows to create a file upload request by generating a unique `file_id` to reference the file.
This file can be used for various purposes such as evidence for dispute representment, compliance checks, or other necessary documentation uploads.

Endpoint: POST /file/get-upload-url
Version: 1.0.0
Security: merchant, signature

## Header parameters:

  - `merchant` (string, required)

  - `signature` (string, required)

## Request fields (application/json):

  - `file_name` (string, required)
    Name of the file, including its extension.
Should be provided one of extensions jpg, jpeg, png, gif, txt, pdf, doc, docx, rtf, xls, xlsx, csv.
    Example: document.pdf

  - `file_type` (string, required)
    Mime type of the file, must match the extension.
Should be provided one of the following mime types image/jpeg for .jpg/.jpeg, image/png for .png, image/gif for .gif, etc.
    Example: application/pdf

  - `file_size` (integer, required)
    Size of the file in bytes.
    Example: 1024000

## Response 200 fields (application/json):

  - `file_id` (string, required)
    Unique identifier of the uploaded file.

  - `upload_url` (string, required)
    Pre-signed URL for file content upload.

  - `error` (object, required)
    Error object.

  - `error.code` (string, required)
    Unauthorized access due to invalid credentials.
    Example: 1.01

  - `error.messages` (array, required)
    Array of error messages applied to the decline payment.