API

속성 생성

작성일 2026.03.24 | 수정일 2026.03.25

POST/crm-core/v1/properties

CRM 개체에 새로운 속성을 추가합니다. OWNER 권한이 필요합니다.

chat

지원하는 속성 유형: TEXT, TEXTAREA, NUMBER, CURRENCY, PERCENT, PHONE, EMAIL, CHECKBOX, MULTI_CHECKBOX, DATE, DATETIME, DROPDOWN, RADIO

Body Params

Name	Type	Required	Description
entityId	string	*	개체 고유 아이디
name	string	*	속성 이름
description	string		속성 설명
fieldType	string	*	속성 유형 (TEXT, TEXTAREA, NUMBER, CURRENCY, PERCENT, PHONE, EMAIL, CHECKBOX, MULTI_CHECKBOX, DATE, DATETIME, DROPDOWN, RADIO)
propertyGroupId	string		속성 그룹 ID
options	Array<Object>		선택지 목록 (DROPDOWN, RADIO, CHECKBOX 등에서 사용)
label	string	*	선택지 라벨
value	string	*	선택지 값
priority	number	*	정렬 순서

Response

Name	Type	Required	Description
propertyId	string	*	속성 고유 아이디
accountId	string	*	계정 고유 아이디
entityId	string	*	개체 ID
name	string	*	속성 이름
description	string		속성 설명
fieldType	string	*	속성 유형
propertyGroupId	string		속성 그룹 ID
options	Array<Object>		선택지 목록
label	string	*	선택지 라벨
value	string	*	선택지 값
priority	number	*	정렬 순서
dateCreated	date	*	최초 생성 날짜
dateUpdated	date	*	최근 수정 날짜

Structure

Request Structure

{
  "entityId": "ENT20260324090000ABCDEFGHIJKLMNO",
  "name": "샘플",
  "description": "설명 텍스트",
  "fieldType": "TEXT",
  "propertyGroupId": "ID_SAMPLE_12345",
  "options": [
    {
      "label": "라벨",
      "value": "샘플값",
      "priority": 1
    }
  ]
}

Response Structure

{
  "propertyId": "PROP20260324090000ABCDEFGHIJKLM",
  "accountId": "24010100001234",
  "entityId": "ENT20260324090000ABCDEFGHIJKLMNO",
  "name": "샘플",
  "description": "설명 텍스트",
  "fieldType": "TEXT",
  "propertyGroupId": "ID_SAMPLE_12345",
  "options": [
    {
      "label": "라벨",
      "value": "샘플값",
      "priority": 1
    }
  ],
  "dateCreated": "2026-03-24T09:00:00.000Z",
  "dateUpdated": "2026-03-24T09:00:00.000Z"
}