---
title: "Create a file asset"
method: POST
path: "/v1/assets/files"
tags: ["Assets"]
---

# Create a file asset

`POST /v1/assets/files`

Creates a new file asset.

Accepted file types: `image/bmp`, `image/jpeg`, `image/jpg`, `image/png`, `image/gif`, `application/pdf`. Maximum file size: 2 MB. Maximum image dimensions: 4096px.

## Response `200`

The newly created file asset.

- object
  - `asset` AssetFile
    - `id` integer — The unique identifier of the file asset.
    - `name` string — The display name of the file asset.
    - `parent_folder_id` integer, nullable — The ID of the parent folder, or null if the asset is at the root level.
    - `path` string — The storage URL or path where the file is hosted.
    - `size` integer — The file size in bytes.
    - `created` integer — Unix timestamp when the asset was created.
    - `updated` integer — Unix timestamp when the asset was last updated.

## Other responses

- `400` — Bad request
- `401` — Unauthorized - missing or invalid API key
- `404` — Resource not found
- `409` — Conflict - linked resource or other constraint violation

---

[API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) · [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/customer/customer-io-journeys-api-reference/revisions/4b391af7cb06/schema)