---
title: "Create Asset"
method: POST
path: "/entities/asset"
tags: ["4. Assets"]
---

# Create Asset

`POST /entities/asset`

Create a new asset.

The asset must be associated with an existing site. Returns the created asset details including the assigned UUID.

## Request body

- AssetRequest — Request model for creating a new asset.
  - `external_id` string, required — Vendor-specific identifier for the asset
  - `type` 'charger' | 'battery' | 'heat pump' | 'electric_vehicle' | 'hot water tank', required — Asset types that can be created through the API.
  - `site_id` string, uuid, required — ID of the site where the asset is located
  - `properties` AssetProperties — Optional properties for an asset.
    - `power_kw` number — Power rating in kW
    - `capacity_kwh` number — Capacity in kWh
  - `asset_model` string — Name of the AssetModel to assign (looked up by name)
  - `installation_date` string, date — Date when the asset was installed
  - `serial_number` string — The serial number of the asset

## Response `200`

Successfully created asset

- AssetResponse — Response model for asset information.
  - `id` string, uuid, required — Axle's internal UUID for the asset
  - `external_id` string, required — Vendor-specific identifier for the asset
  - `type` 'boundary meter' | 'charger' | 'battery' | 'heat pump' | 'hot water tank' | 'frequency meter' | 'electric_vehicle' | 'pv inverter', required — An enumeration.
  - `site_id` string, uuid, required — ID of the site where the asset is located
  - `properties` AssetProperties — Optional properties for an asset.
    - `power_kw` number — Power rating in kW
    - `capacity_kwh` number — Capacity in kWh

## Other responses

- `400` — Invalid request
- `404` — Referenced site not found
- `409` — Asset already exists
- `422` — Validation Error
- `500` — Server error while creating asset

---

[API](https://skmtc.dev/axle/apis/axle-api-docs.md) · [All operations](https://skmtc.dev/axle/apis/axle-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/axle/axle-api-docs/revisions/75be7f9a952f/schema)