post
https://api.safetyculture.io/assets/v1/fields
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_optionswith at least one option. - Each option requires an
idandlabel. - 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.