---
title: "Create/Upload a new file to your account."
method: POST
path: "/files"
tags: ["Files"]
---

# Create/Upload a new file to your account.

`POST /files`

Upload a file to Ryft via our API. Useful if you need to:
  - upload evidence when challenging disputes
  - upload KYB/KYC documents for sub accounts

## Headers

- `Account` string

## Response `200`

The file was created & uploaded successfully

- File
  - `id` string — The ID of the file
  - `name` string — Name of the file
  - `type` 'Csv' | 'Jpg' | 'Png' | 'Pdf' — The type of the file
  - `category` 'Report' | 'Evidence' | 'VerificationDocument' — The category of the file
  - `metadata` object, nullable — Any additional key-value data you have attached to the file. These will be sent with any associated file events on your webhooks. You can have a maximum of 5 pieces of metadata.
  - `createdTimestamp` integer — The epoch timestamp (seconds) when the file was created
  - `lastUpdatedTimestamp` integer — The epoch timestamp (seconds) when the file was last updated
  - `sizeInBytes` integer, nullable — The size in bytes of the associated file

## Other responses

- `400` — One or more inputs are invalid
- `500` — An unexpected error occurred when executing this request

---

[API](https://skmtc.net/ryftpay/apis/ryft-payment-api.md) · [All operations](https://skmtc.net/ryftpay/apis/ryft-payment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ryftpay/ryft-payment-api/revisions/a042f64d4305/schema)