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

# Create a custom field

`POST /custom-fields`

## Request

- Base URL: `https://sending.dev/api/v1`
- URL: `https://sending.dev/api/v1/custom-fields`
- Auth: HTTP bearer

Required scope: `contacts:write`.

## Request body

- CreateCustomFieldInput
  - `label` string, required
  - `type` 'text' | 'number' | 'date' | 'select' | 'multiselect' | 'boolean' | 'url', required
  - `options` string[]
  - `groupName` string

## Response `201`

Field created.

- object
  - `id` string, required
  - `key` string, required

## Other responses

- `401`: Missing or invalid token.
- `403`: Insufficient scope.
- `409`: State conflict (e.g. duplicate).
- `422`: Invalid input.

---

[API](https://skmtc.dev/sending/apis/sending-dev-api.md) · [All operations](https://skmtc.dev/sending/apis/sending-dev-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sending/apis/sending-dev-api/revisions/9fe78d2918a1?raw)