---
title: "Create an Asset"
method: POST
path: "/2024-09/account/assets"
tags: ["Settings"]
---

# Create an Asset

`POST /2024-09/account/assets`

## Request

- Base URL: `https://public-api.easyship.com`
- URL: `https://public-api.easyship.com/2024-09/account/assets`
- Auth: HTTP bearer

Create an asset. 

> You can store up to five assets for each type.
> Allowed file types: png or jpeg.

Required authorization scope: `public.asset:write`

## Request body `multipart/form-data`

- AssetCreate
  - `type` Type, required (unresolved $ref)
  - `name` string: Asset name
  - `file` string, binary, required

## Response `201`

assets successfully created

- AssetList: List all assets
  - `assets` Asset[]
    - `id` string, uuid
    - `type` 'logo' | 'tracking_page_ad' | 'tracking_email_ad': Asset type
    - `name` string, nullable: Asset name
    - `url` string, uri: Asset link
  - `meta` MetaWithPagination
    - `pagination` Pagination: Pagination
      - `next` integer, nullable
      - `count` integer, nullable: The total number of items. The `null` value is used with countless pagination (used for faster response on large datasets, like shipments).
      - `page` integer: Current page
    - `request_id` string: An unique ID represent the request.

## Other responses

- `400`: uploaded assets count exceeds limitation

---

[API](https://skmtc.dev/easyship/apis/easyship-public-api.md) - [All operations](https://skmtc.dev/easyship/apis/easyship-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/easyship/apis/easyship-public-api/revisions/b47b54b748a7?raw)