---
title: "Create an organization contact field"
method: POST
path: "/contacts/fields"
tags: ["Contact Fields"]
---

# Create an organization contact field

`POST /contacts/fields`

This operation creates an organization contact field for the given organization. This field will appear on all contacts in the interface. Requesting creation of an already existing field will result in a `201` response and the response will contain the existing field.

## Headers

- `s-idempotency-key` string

## Request body

- ContactCustomFieldNameContent
  - `name` string, required — A name for the field

## Response `201`

created

- ContactOrganizationContactFieldName
  - `id` string, required — Spruce's contact organization contact custom field ID
  - `name` string, required — A name for the field

## Other responses

- `400` — bad request
- `422` — duplicate request
- `500` — unexpected error

---

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