Create a custom field that can be used across assets in your organization. After creating a field, associate it with asset types using the Update an asset type endpoint.

Field value types

Choose the appropriate value type for your field:

String: This field type allows you to limit input to text only. Users can enter details like serial numbers, descriptions, or notes.
Money: This field type allows you to limit input to monetary values. It is ideal for logging cost, purchase price, and more. Currency values are displayed with up to two decimal points, except for currencies following a zero-decimal or three-decimal standard.
Timestamp: This field type allows users to select a date. It is helpful in tracking purchase dates, expiration dates, and other similar dates.
Select: This field type allows you to set a predefined list of options (requires select_options). Users can select just one option, such as vehicle color or fuel source.

Select fields

When creating a select field (FIELD_VALUE_TYPE_SELECT):

You must provide select_options with at least one option.
Each option requires an id and label.
Maximum 100 options per field.
Options cannot be removed after creation.

Requirements

🚧
Creating a field does not automatically make it available on assets. You must associate the field with specific asset types using the Update asset type and field association endpoint before it can be used. Alternatively, you can edit your asset type fields via the web app.

200A successful response.

defaultAn unexpected error response.