---
title: "/fields"
method: POST
path: "/fields"
---

# /fields

`POST /fields`

## Request

- Base URL: `https://develop.snipeitapp.com/api/v1`
- URL: `https://develop.snipeitapp.com/api/v1/fields`
- Auth: none required

Create a custom field

## Request body

- object
  - `name` string, required: The field's name, which is also the form label
  - `element` 'text' | 'textarea' | 'checkbox' | 'radio' | 'listbox', required: Form field type that should be displayed.
  - `field_values` string: In the case of list boxes, etc, this should be a list of the options available
  - `show_in_email` boolean: Whether or not to show the custom field in email notifications
  - `format` string: Validation constraints on this field
  - `field_encrypted` boolean: Whether the field should be encrypted. (This can cause issues if you change it after the field was created.)
  - `help_text` string: Any additional text you wish to display under the new form field to make it clearer what the gauges should be.

## Response `200`

200

## Other responses

- `401`: 401
- `405`: 405

## Changes

- **2026-11-03** `938bea5e8375`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/snipeitapp/apis/snipe-it-rest-api/changes/fields/post.md)

---

[API](https://skmtc.dev/snipeitapp/apis/snipe-it-rest-api.md) - [All operations](https://skmtc.dev/snipeitapp/apis/snipe-it-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/snipeitapp/apis/snipe-it-rest-api/revisions/938bea5e8375?raw)