---
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.

## Changes

- **2026-08-12** `00db66c44181` — 1 info
  - api operation id `FieldDefinitions_Post` removed and replaced with `post-fielddefinitions`

[Change history](https://skmtc.dev/ownerrez/apis/ownerrez-api/changes/v2/fielddefinitions/post.md)

---

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