---
title: "Create a custom contact field"
method: POST
path: "/contact-fields"
tags: ["Contact Fields"]
---

# Create a custom contact field

`POST /contact-fields`

Creates a custom field for contacts. The `name` is auto-generated from the `label` as a slug.
Valid field type IDs: text, number, date (use the UUID constants from the contact_field_types table).

## Request body

- object
  - `label` string, required — Human-readable field label
  - `contact_field_type_id` string, required — UUID of the field type (text, number, or date)

## Response `201`

Contact field created

- UserContactField
  - `id` integer
  - `label` string, required — Human-readable field label
  - `name` string — Machine-readable slug (auto-generated from label)
  - `type` 'text' | 'number' | 'date' — Field type

## Other responses

- `422` — Validation error

---

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