---
title: "Create Contact Field"
method: POST
path: "/v1/contact/contact_fields"
tags: ["contact"]
---

# Create Contact Field

`POST /v1/contact/contact_fields`

## Request

- Base URL: `https://api.linktodm.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.linktodm.com/v1/contact/contact_fields`
- Auth: HTTP bearer

Create a custom User Field definition.

## Request body

- ContactFieldDefinitionCreate: Payload for creating a custom User Field (the create-field modal).
  - `name` string, required
  - `type` 'TEXT' | 'NUMBER' | 'DATE' | 'DATETIME' | 'BOOLEAN' | 'ARRAY': Data type of a custom contact User Field.
  - `description` string, nullable
  - `folder` string, nullable

## Response `200`

Successful Response

- ContactFieldDefinitionResponse
  - `id` integer, required
  - `name` string, required
  - `slug` string, required
  - `type` 'TEXT' | 'NUMBER' | 'DATE' | 'DATETIME' | 'BOOLEAN' | 'ARRAY', required: Data type of a custom contact User Field.
  - `description` string, nullable
  - `folder` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/linktodm/apis/salesmorph.md) - [All operations](https://skmtc.dev/linktodm/apis/salesmorph/llms.txt) - [OpenAPI document](https://skmtc.dev/linktodm/apis/salesmorph/revisions/4af0ad5dbe92?raw)