---
title: "Create a new asset"
method: POST
path: "/v1/assets"
---

# Create a new asset

`POST /v1/assets`

## Headers

- `X-Time-Zone` string
- `X-User-Id` integer

## Request body

- object
  - `name` string, required — Denotes the name of the asset that you are creating.
  - `type` string, required — Denotes the type of the asset that you are creating. Allowed values are ["dry_box", "reefer", "flatbed", "step_deck", "tanker", "low_boy", "intermodal_chassis", "auto_hauler", "livestock", "dump_tipper", "curtain_side", "stake", "construction", "other"]
  - `custom_type` string — Specify the custom type of the asset. If not available, mention it as "Other".
  - `make` string, required — Denotes make of the asset that you are creating.
  - `model` string, required — Denotes the model of the asset that you are creating.
  - `year` string, required — Denotes the year of manufacturing of the asset.
  - `subtype` string — Specify the sub type of the asset. Allowed values are: ["backhoe", "boom_truck", "bulldozer", "crane", "dump_truck", "excavator", "forklift", "front_loader", "grader", "trencher", "other"]
  - `vin` string — Specify the VIN number of the asset.
  - `length` number, float — Specify the length of the asset.
  - `axle` integer — Provide the axle information of the asset.
  - `gvwr` integer — Gross Vehicle Weight Rating (GVWR) of the asset.
  - `gawr` integer — Gross Axle Weight Rating (GAWR) of the asset.
  - `length_metric_units` boolean — Specify if length is in metric units.
  - `weight_metric_units` boolean — Specify if the weight is in metric units.
  - `license_plate_state` string — Mention the state where the license place was installed.
  - `license_plate_number` string — Mention the number of license plate.
  - `leased` boolean — Mention if the asset is leased or not.
  - `notes` string — Specify any notes for the asset.
  - `asset_gateway_id` string — Mention the ID of the asset gateway with which the asset with linked.
  - `external_ids_attributes` object — Specify the external Id attributes for the asset.
    - `external_id` string, required — Denotes the external ID of the entity.
    - `integration_name` string, required — The integration with which the external_id is associated.
    - `external_id_holder_id` integer, required — The unique identifier assigned to the entity such as a user, vehicle, asset, or a group. If your entity is a user, then enter the user ID here. If a vehicle, enter the vehicle ID. Similarly for asset (asset ID), and group (group ID).
    - `external_id_holder_type` string, required — Type of the external ID holder. Allowed values are <ul><li><b>User</b></li><li><b>Vehicle</b></li><li><b>Asset</b></li><li><b>Group</b></ul>
  - `group_ids` integer[] — Specify the group IDs for the assets.
  - `availability_details` object
    - `availability_status` string — Denotes the availability status of the vehicle/asset. Allowed values are <ul><li><b>out_of_service</b></li> or <li><b>in_service</b></li></ul>
    - `additional_note` string — Denotes any comments or notes added for updating the availability of the vehicle/asset. For example, “This vehicle/asset is scheduled for maintenance”.
    - `custom_driver_app_warning_prompt` string — This denotes the prompt message that drivers see on their driver_app. This prompt can be used to inform the driver about the status of the vehicle/asset or communicate any specific instructions. For example, “Vehicle/Asset is under maintenance, do not operate. ”

## Response `200`

200

- object
  - `assets` object[]
    - `asset` object
      - `id` integer
      - `name` string
      - `status` string
      - `type` string
      - `custom_type` unknown
      - `vin` unknown
      - `license_plate_state` unknown
      - `license_plate_number` unknown
      - `make` string
      - `model` string
      - `year` string
      - `axle` unknown
      - `weight_metric_units` boolean
      - `length_metric_units` boolean
      - `leased` unknown
      - `notes` unknown
      - `length` unknown
      - `gvwr` unknown
      - `gawr` unknown
      - `asset_gateway` object
        - `id` integer
        - `identifier` string
        - `active` boolean
      - `external_ids` object[]
      - `availability_details` object
        - `availability_status` string
        - `out_of_service_reason` string
        - `updated_at` string
        - `additional_note` string
        - `custom_driver_app_warning_prompt` string
        - `updated_by_user` object
          - `id` integer
          - `first_name` string
          - `last_name` string
          - `user_name` string
          - `email` string
          - `company_reference_id` integer
          - `status` string
          - `role` string
  - `pagination` object
    - `per_page` integer
    - `page_no` integer
    - `total` integer

## Other responses

- `403` — 403

---

[API](https://skmtc.net/gomotive/apis/motive.md) · [All operations](https://skmtc.net/gomotive/apis/motive/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gomotive/motive/revisions/c71780e497f5/schema)