---
title: "Create Custom Field"
method: POST
path: "/custom_fields"
tags: ["Custom Fields"]
---

# Create Custom Field

`POST /custom_fields`

Create a new custom field belonging to the provided organization.

## Request body

- object — Creates a new custom field.
  - `name` string, required — The name of the custom field.
  - `agentVisible` boolean, required — Whether the custom field is visible to agents.
  - `organizationId` string, required — The organization this custom field is scoped to.

## Response `201`

Returns the created custom field.

- CustomField — A custom field is a custom property that can be attached to a lead.
  - `id` string, required — The ID of the custom field.
  - `type` 'custom_field', required — The type of object the attached ID corresponds to.
  - `name` string, required — The name of the custom field.
  - `agentVisible` boolean, required — Whether the custom field is visible to agents.
  - `organizationId` string — The organization this custom field is scoped to (if any).
  - `createdAt` string, required — An ISO-8601 string representing the date the custom field was created.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

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