---
title: "Create a New Asset"
method: POST
path: "/assets"
tags: ["Assets"]
---

# Create a New Asset

`POST /assets`

Create a new asset in your SysAid account.

## Request body

- AssetCreate
  - `name` string — The name of the asset.
  - `type` string, nullable — The asset type (Laptop / Smartphone / etc.).
  - `source` string, nullable — The origin of the asset, describing how it was added to the system.
  - `manufacturer` string, nullable — The manufacturer of the asset.
  - `model` string, nullable — The model of the asset.
  - `serial` string, nullable — The asset's serial number according to the manufacturer.
  - `description` string, nullable — The description of the asset.
  - `isDisabled` boolean — Indicates whether the asset is disabled. When true, automatic inventory updates, monitoring, and all other SysAid Agent capabilities are turned off for the asset.
  - `ownerId` number, nullable — The unique ID of the user who owns the asset.
  - `ownership` 'personal' | 'company', nullable — Defines who is the official owner of the asset - the employee or the company.
  - `companyId` number, nullable — The unique ID of the company the asset belongs to.
  - `locationId` number, nullable — The unique ID of the asset’s location.
  - `departmentId` number, nullable — The unique ID of the department the asset belongs to.
  - `warrantyExpiration` string, date, nullable — The date when the asset’s warranty expires.
  - `patchManagementEnabled` boolean — Indicates if patch management is enabled for the asset. To learn more, see SysAid Patch Management Guide.
  - `os` OperatingSystem, nullable — Operating System properties.
    - `name` string, nullable — The name of the Operating System.
    - `version` string, nullable — The version of the Operating System.
  - `network` Network, nullable — Network properties.
    - `macAddresses` string[] — The MAC addresses that belong to the asset.
    - `ipAddresses` string[] — The IP addresses of the asset.
  - `customFields` FlattenedCustomColumnsFields
  - `additionalData` string, nullable — Additional data available for the asset.

## Response `201`

Asset created successfully.

- AssetCreateResponse
  - `success` boolean
  - `id` string

## Other responses

- `400` — The request was invalid or cannot be served
- `401` — Authentication information is missing or invalid
- `403` — The server understood the request but refuses to authorize it
- `409` — The request could not be completed due to a conflict with the current state of the resource. This typically occurs when attempting to create a duplicate resource, update a resource that has been modified by another process, or when business rules prevent the operation.

---

[API](https://skmtc.net/sysaid/apis/sysaid-public-api.md) · [All operations](https://skmtc.net/sysaid/apis/sysaid-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sysaid/sysaid-public-api/versions/38a43a1b2981/schema)
