---
title: "Create a custom field"
method: POST
path: "/v4/custom_fields"
tags: ["Custom Fields"]
---

# Create a custom field

`POST /v4/custom_fields`

Create a custom field for your account. The label field must be unique to your account. Whitespace will be removed from the beginning and the end of your label.<br/><br/>Additionally, a key field and a name field will be generated for you. The key is an ASCII-only, lowercased, underscored representation of your label. This key must be unique to your account. Keys are used in personalization tags in sequences and broadcasts. Names are unique identifiers for use in the HTML of custom forms. They are made up of a combination of ID and the key of the custom field prefixed with "ck_field".

## Request body

- object
  - `label` string, required

## Response `200`

Returns a 200 and the custom field if it already exists

- object
  - `custom_field` object, required
    - `id` integer, required
    - `name` string, required
    - `key` string, required
    - `label` string, required

## Other responses

- `201` — Creates a new custom field and returns its details
- `401` — Returns a 401 if the token and/or account cannot be authenticated
- `422` — Returns a 422 with an error message when the label is missing

---

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