--- title: "Create a new asset." method: POST path: "/assets" tags: ["Assets"] --- # Create a new asset. `POST /assets` ## Request - Base URL: `https://api.samsara.com` - URL: `https://api.samsara.com/assets` - Auth: HTTP bearer Create a new asset. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Assets** under the Assets category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. ## Request body - AssetsCreateAssetRequestBody: Representation of a vehicle trailer or other equipment to be tracked. - `attributes` GoaAttributeTinyRequestBody[]: A list of attributes to assign to the asset. If provided, this replaces the asset's entire set of attribute associations with exactly this list; omit this field to leave existing attribute associations unchanged, or pass an empty array to clear them. - `dateValues` string[]: List of date values associated with the attribute (RFC 3339 full-date format: YYYY-MM-DD). - `id` string: Id of the attribute - `name` string: Name of the attribute - `numberValues` number[]: List of number values associated with the attribute - `stringValues` string[]: List of string values associated with the attribute. - `externalIds` object: A map of external ids - `licensePlate` string: The license plate of the asset. - `make` string: The OEM/manufacturer of the asset. Updates to this field are restricted. - `model` string: The model of the asset. Updates to this field are restricted. - `name` string: The human-readable name of the asset. This is set by a fleet administrator and will appear in both Samsara’s cloud dashboard as well as the Samsara Driver mobile app. By default, this name is the serial number of the Samsara Asset Gateway. It can be set or updated through the Samsara Dashboard or through the API at any time. - `notes` string: These are generic notes about the asset. Can be set or updated through the Samsara Dashboard or the API at any time. - `readingsIngestionEnabled` boolean: Indicates whether the asset is expected to have data ingested using the Readings API. Do not set this to true for an asset that has, or is intended to have, a connected gateway. - `regulationMode` 'mixed' | 'regulated' | 'unregulated': Whether or not the asset is regulated, unregulated (non-CMV), or a mixed use unregulated asset. Primarily used with vehicles. Valid values: `mixed`, `regulated`, `unregulated` - `serialNumber` string: The serial number of the asset. This can be an internal serial number or used to hold legacy VIN/PIN numbers such as ones of shorter lengths. - `tagIds` string[]: An array of IDs of tags to associate with this asset. If provided, this replaces the asset's entire set of tag associations with exactly this list; omit this field to leave existing tag associations unchanged, or pass an empty array to clear them. If your access to the API is scoped by one or more tags, this field is required to pass in. - `type` 'uncategorized' | 'trailer' | 'equipment' | 'unpowered' | 'vehicle': The operational context in which the asset interacts with the Samsara system. Examples: Vehicle (eg: truck, bus...), Trailer (eg: dry van, reefer, flatbed...), Powered Equipment (eg: dozer, crane...), Unpowered Equipment (eg: container, dumpster...), or Uncategorized. Valid values: `uncategorized`, `trailer`, `equipment`, `unpowered`, `vehicle` - `vin` string: The unique 17-digit VIN (Vehicle Identification Number) or PIN (Product Identification Number) of the asset. - `year` integer: The model year of the asset. Updates to this field are restricted. ## Response `200` OK response. - AssetsCreateAssetResponseBody - `data` AssetResponseBody, required: Representation of a vehicle trailer or other equipment to be tracked. - `attributes` GoaAttributeTinyResponseBody[]: List of attributes associated with the entity - `dateValues` string[]: List of date values associated with the attribute (RFC 3339 full-date format: YYYY-MM-DD). - `id` string: Id of the attribute - `name` string: Name of the attribute - `numberValues` number[]: List of number values associated with the attribute - `stringValues` string[]: List of string values associated with the attribute. - `createdAtTime` string, required: The time the asset was created in RFC 3339 format. - `externalIds` object: A map of external ids - `id` string, required: The unique ID of the asset. - `licensePlate` string: The license plate of the asset. - `make` string: The OEM/manufacturer of the asset. Updates to this field are restricted. - `model` string: The model of the asset. Updates to this field are restricted. - `name` string: The human-readable name of the asset. This is set by a fleet administrator and will appear in both Samsara’s cloud dashboard as well as the Samsara Driver mobile app. By default, this name is the serial number of the Samsara Asset Gateway. It can be set or updated through the Samsara Dashboard or through the API at any time. - `notes` string: These are generic notes about the asset. Can be set or updated through the Samsara Dashboard or the API at any time. - `readingsIngestionEnabled` boolean: Indicates whether the asset is expected to have data ingested using the Readings API. Do not set this to true for an asset that has, or is intended to have, a connected gateway. - `regulationMode` 'mixed' | 'regulated' | 'unregulated': Whether or not the asset is regulated, unregulated (non-CMV), or a mixed use unregulated asset. Primarily used with vehicles. Valid values: `mixed`, `regulated`, `unregulated` - `serialNumber` string: The serial number of the asset. This can be an internal serial number or used to hold legacy VIN/PIN numbers such as ones of shorter lengths. - `tags` GoaTagTinyResponseResponseBody[]: The list of [tags](https://kb.samsara.com/hc/en-us/articles/360026674631-Using-Tags-and-Tag-Nesting) associated with the Asset. - `id` string, required: ID of the tag - `name` string, required: Name of the tag. - `parentTagId` string: If this tag is part a hierarchical tag tree, this is the ID of the parent tag, otherwise this will be omitted. - `type` 'uncategorized' | 'trailer' | 'equipment' | 'unpowered' | 'vehicle': The operational context in which the asset interacts with the Samsara system. Examples: Vehicle (eg: truck, bus...), Trailer (eg: dry van, reefer, flatbed...), Powered Equipment (eg: dozer, crane...), Unpowered Equipment (eg: container, dumpster...), or Uncategorized. Valid values: `uncategorized`, `trailer`, `equipment`, `unpowered`, `vehicle` - `updatedAtTime` string, required: The time the asset was last updated in RFC 3339 format. - `vin` string: The unique 17-digit VIN (Vehicle Identification Number) or PIN (Product Identification Number) of the asset. - `year` integer: The model year of the asset. Updates to this field are restricted. ## Other responses - `401`: Unauthorized response. - `404`: Not Found response. - `405`: Method Not Allowed response. - `413`: Content Too Large response. - `429`: Too Many Requests response. - `500`: Internal Server Error response. - `501`: Not Implemented response. - `502`: Bad Gateway response. - `503`: Service Unavailable response. - `504`: Gateway Timeout response. - `default`: Bad Request response. --- [API](https://skmtc.dev/samsara/apis/samsara-api.md) - [All operations](https://skmtc.dev/samsara/apis/samsara-api/llms.txt) - [OpenAPI document](https://skmtc.dev/samsara/apis/samsara-api/revisions/a9e35d4999be?raw)