---
title: "Create a new field definition."
method: POST
path: "/v2/fielddefinitions"
tags: ["FieldDefinitions"]
---

# Create a new field definition.

`POST /v2/fielddefinitions`

## Request body

- FieldDefinitionModel
  - `id` integer — The ID of this record.
  - `code` string — The field code without any prefix. E.g. "F1".
  - `description` string
  - `full_code` string — The fully qualified field code as used in templates. E.g. "BXF1".
  - `name` string
  - `type` 'booking' | 'property' | 'account' | 'owner' | 'contact' — The type of records to which this field applies.

## Response `200`

A model representing the field definition created.

- FieldDefinitionModel
  - `id` integer — The ID of this record.
  - `code` string — The field code without any prefix. E.g. "F1".
  - `description` string
  - `full_code` string — The fully qualified field code as used in templates. E.g. "BXF1".
  - `name` string
  - `type` 'booking' | 'property' | 'account' | 'owner' | 'contact' — The type of records to which this field applies.

---

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