---
title: "Create a file object and retrieve the file upload URL"
method: POST
path: "/catalog-connector-files"
tags: ["Catalog Connector Files"]
---

# Create a file object and retrieve the file upload URL

`POST /catalog-connector-files`

## Request

- Base URL: `https://api.fabric.inc/v3`
- URL: `https://api.fabric.inc/v3/catalog-connector-files`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/fabric/apis/catalog-connector/docs/catalog-connector-files/post.ts> (a function with typed inputs; its response is checked against the schema)

Use this endpoint to retrieve the URL of the AWS S3 location to upload the file that you want to import to the Catalog Connector.

## Headers

- `x-fabric-tenant-id` string, required
- `x-fabric-request-id` string

## Request body

- object: A sample request to create a file object and retrieve the upload URL to import products to the Catalog Connector.
  - `type` 'CATALOG_CONN_ITEM_VARIANT_IMPORT' | 'CATALOG_CONN_ITEM_VARIANT_EXPORT' | 'CATALOG_CONN_BUNDLE_IMPORT' | 'CATALOG_CONN_BUNDLE_EXPORT', required: Specify the type of operation or job performed by uploading the file.
  - `name` string, required: The name of the file to be imported.
  - `locale` string, required: The language code, which is a combination of language (ISO 639 format) and country (ISO 3166 format). The default value is `en-US`.
  - `formatType` 'csv' | 'jsonl', required: Specify the file format used to upload to Catalog Connector.

## Response `200`

OK

- File: The details of the file.
  - `id` string: A 24-character system-generated file ID.
  - `type` 'CATALOG_CONN_ITEM_VARIANT_IMPORT' | 'CATALOG_CONN_ITEM_VARIANT_EXPORT' | 'CATALOG_CONN_BUNDLE_IMPORT' | 'CATALOG_CONN_BUNDLE_EXPORT': Specify the type of operation or job performed by uploading the file.
  - `name` string: The name of the file name to be uploaded to the AWS S3 location.
  - `locale` string: The language code, which is a combination of language (ISO 639 format) and country (ISO 3166 format). The default value is `en-US`.
  - `formatType` 'csv' | 'jsonl': Specify the file format used to upload to Catalog Connector.
  - `createdAt` string: The time of file creation, in UTC format.
  - `updatedBy` string: The email of the user who last updated the file.
  - `updatedAt` string: The time of last update to the file, in UTC format.
  - `location` string: The AWS S3 file location of the imported file is provided as a URL.

## Other responses

- `400`: Request is invalid or malformed
- `401`: The requester is unauthorized.
- `403`: The user isn't allowed to perform this action.
- `500`: Internal server error

---

[API](https://skmtc.dev/fabric/apis/catalog-connector.md) - [All operations](https://skmtc.dev/fabric/apis/catalog-connector/llms.txt) - [OpenAPI document](https://skmtc.dev/fabric/apis/catalog-connector/revisions/878ef9866561?raw)