---
title: "Create a new custom field."
method: POST
path: "/dashboards/{dashboard_id}/fields"
tags: ["Custom Fields"]
---

# Create a new custom field.

`POST /dashboards/{dashboard_id}/fields`

Create a custom field with the provided name.

## Path parameters

- `dashboard_id` integer, required

## Request body

- PostCustomField
  - `name` string — Name of the custom field.

## Response `200`

The new custom field object.

- CustomField
  - `id` string — This will be a Guid that you can use to set a contact's custom field.
  - `name` string — Name of the custom field.

## Other responses

- `400` — Bad request. Sent if too many custom fields alreay exist for this dashboard, or invalid parameters were passed.
- `401` — Unauthorized. Sent if the API key is omitted or invalid.

---

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