---
title: "POST /custom_field_groups"
method: POST
path: "/custom_field_groups"
tags: ["custom_field_groups"]
---

# POST /custom_field_groups

`POST /custom_field_groups`

Create a custom field group

## Request body

- PostCustomFieldGroups — Create a custom field group
  - `name` string, required
  - `entity` 'for_clients' | 'for_properties' | 'for_projects' | 'for_brokers' | 'for_tasks' | 'for_deals', required
  - `on_landing_page` boolean

## Response `201`

Create a custom field group

- CustomFieldGroupEntity — CustomFieldGroupEntity model
  - `id` integer
  - `name` string
  - `entity` string
  - `on_landing_page` boolean
  - `position` integer

## Other responses

- `400` — validation_error
- `401` — authentication_error
- `403` — authorization_error
- `404` — not_found_error
- `422` — validation_error
- `500` — internal_server_error

## Changes

> 3 revisions in range; 1 could not be searched.

- **2026-08-21** `ae1e0fe6da1a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/propstack/apis/propstack-api-v2-beta/changes/custom_field_groups/post.md)

---

[API](https://skmtc.dev/propstack/apis/propstack-api-v2-beta.md) · [All operations](https://skmtc.dev/propstack/apis/propstack-api-v2-beta/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/propstack/propstack-api-v2-beta/revisions/d6de300d9118/schema)