---
title: "Create an asset field"
method: POST
path: "/assets/v1/fields"
tags: ["Assets"]
---

# Create an asset field

`POST /assets/v1/fields`

## Request body

- S12AssetsV1CreateFieldRequest — The parameters for `CreateField`
  - `name` string — Name of the field.
  - `value_type` 'FIELD_VALUE_TYPE_UNSPECIFIED' | 'FIELD_VALUE_TYPE_STRING' | 'FIELD_VALUE_TYPE_MONEY' | 'FIELD_VALUE_TYPE_TIMESTAMP' | 'FIELD_VALUE_TYPE_SELECT' — Describes each type of asset field. - FIELD_VALUE_TYPE_UNSPECIFIED: Field value type unspecified. - FIELD_VALUE_TYPE_STRING: This type accepts plain text values. - FIELD_VALUE_TYPE_MONEY: This type accepts numerical values with currency codes. For example, "99.99" numerical value with "AUD" as the currency code. - FIELD_VALUE_TYPE_TIMESTAMP: This type accepts timestamp values in the Internet Date-Time format. - FIELD_VALUE_TYPE_SELECT: This type accepts select values.
  - `select_options` S12TypefieldV1FieldOption[] — Optional. The options of a field select. 100 limit enforced in typefield, but to lower the feedback loop, we enforce it here too.
    - `id` string — The id of a field select option.
    - `label` string — The label of a field select option.
    - `order` integer — The display order of this option, 0-indexed. Options should be displayed in ascending order of this field, matching the order they were defined in the field settings.

## Response `200`

A successful response.

- S12AssetsV1CreateFieldResponse — Result returned from `CreateField`
  - `id` string — The identifier of the created field.
  - `select_options` S12TypefieldV1FieldOption[] — The select options of the field, if any were created.
    - `id` string — The id of a field select option.
    - `label` string — The label of a field select option.
    - `order` integer — The display order of this option, 0-indexed. Options should be displayed in ascending order of this field, matching the order they were defined in the field settings.

## Other responses

- `default` — An unexpected error response.

---

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