---
title: "Create file upload config"
method: POST
path: "/v1/file_upload_configs"
tags: ["File Upload Configs"]
---

# Create file upload config

`POST /v1/file_upload_configs`

Create the configuration for a file upload request. The configuration contains basic information about the file such as the merchant, idempotency key, and the type of file. Type is the requirement the file is intended to satisfy.

## Headers

- `Rainforest-Api-Version` '2024-10-16' | '2023-12-01'

## Request body

- Data — unresolved $ref

## Response `200`

OK

- object
  - `status` 'SUCCESS' | 'ERROR' — Status of the request. If the request status code is 2XX, then the `status` will be `SUCCESS`. If the request status code is 4XX or 5XX, then the `status` will be `ERROR`.
  - `data` object
    - `file_upload_config_id` FileUploadConfigId — unresolved $ref
    - `file_upload_id` FileUploadId — unresolved $ref
    - `merchant_id` string — The unique merchant identifier. Required if the type is `BUSINESS_NAME_TIN_VERIFICATION`, `BUSINESS_VERIFICATION`, `DEPOSIT_METHOD_VERIFICATION`, `FINANCIAL_REVIEW`, or `OWNER_NAME_SSN_VERIFICATION`. Prefix is "mid" in production and "sbx_mid" in sandbox.
    - `chargeback_id` string — The unique chargeback identifier. Required if the type is `CHARGEBACK_EVIDENCE`. Prefix is "chb" in production and "sbx_chb" in sandbox.
    - `idempotency_key` string — A unique identifier provided by the platform. This key will be used to detect subsequent retries of the same request. Subsequent requests with the same key will return the result of the first request, regardless if the first request succeeded or failed. This identifier should be generated by the platform and can be max 255 characters.
    - `filename` Filename — unresolved $ref
    - `type` 'BUSINESS_NAME_TIN_VERIFICATION' | 'BUSINESS_VERIFICATION' | 'CHARGEBACK_EVIDENCE' | 'DEPOSIT_METHOD_VERIFICATION' | 'FINANCIAL_REVIEW' | 'OWNER_NAME_SSN_VERIFICATION' — The file upload type.
    - `presign_post_data` object — Pass-along data required for presigned endpoint. All key/value pairs must be preserved.
    - `created_at` string, date-time — Date and time file upload config was created at in UTC RFC 3339 format.
    - `updated_at` CreatedAt — unresolved $ref
  - `errors` object[] — List of errors, if applicable.
    - `field` string — The field in the request that had an error, if applicable.
    - `code` string — The code describing the error.
    - `message` string — The description of the error related to the field.

## Other responses

- `400` — Bad request, check for validation errors.
- `401` — Authorization missing or invalid.
- `403` — Authorization insufficient for requested action.
- `5XX` — Unexpected error.

---

[API](https://skmtc.dev/rainforestpay/apis/authentication.md) · [All operations](https://skmtc.dev/rainforestpay/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rainforestpay/authentication/revisions/529a0dab0f90/schema)