API

개체 생성

작성일 2026.03.24 | 수정일 2026.03.25

POST/crm-core/v1/entities

새로운 CRM 개체를 생성합니다. OWNER 권한이 필요합니다.

Body Params

NameTypeRequiredDescription
namestring*개체 이름
slugstring*개체 슬러그 (URL 친화적 식별자)
descriptionstring개체 설명
propertyIdsArray<String>속성 ID 목록
viewSettingsObject보기 설정
modestring보기 모드 (TABLE, BOARD, CALENDAR)
tableObject테이블 보기 설정
pageSizenumber페이지당 표시 개수
boardObject보드 보기 설정
groupByPropertyIdstring그룹핑 기준 속성 ID
sumPropertyIdstring합계 속성 ID
weightPropertyIdstring가중치 속성 ID
aggregationTypestring집계 유형
sortByPropertyIdstring정렬 기준 속성 ID
sortOrderstring정렬 방향
closedWonValuesArray<String>성공 종료 값 목록
closedLostValuesArray<String>실패 종료 값 목록
calendarObject캘린더 보기 설정
datePropertyIdstring날짜 속성 ID
titlePropertyIdstring제목 속성 ID
colorPropertyIdstring색상 속성 ID

Response

NameTypeRequiredDescription
entityIdstring*개체 고유 ID
accountIdstring*계정 고유 ID
namestring*개체 이름
slugstring*개체 슬러그
descriptionstring개체 설명
propertyIdsArray<String>속성 ID 목록
viewSettingsObject보기 설정
ownerIdstring개체 소유자 멤버 ID
dateCreateddate*최초 생성 날짜
dateUpdateddate*최근 수정 날짜

Structure

Request Structure
{ "name": "샘플", "slug": "sample-slug", "description": "설명 텍스트", "propertyIds": [ "샘플값" ], "viewSettings": { "mode": "TABLE", "table": { "pageSize": 20 }, "board": { "groupByPropertyId": "ID_SAMPLE_12345", "sumPropertyId": "ID_SAMPLE_12345", "sortOrder": "DESC" }, "calendar": { "datePropertyId": "ID_SAMPLE_12345", "titlePropertyId": "ID_SAMPLE_12345" } } }
Response Structure
{ "entityId": "ENT20260324090000ABCDEFGHIJKLMNO", "accountId": "24010100001234", "name": "샘플", "slug": "sample-slug", "description": "설명 텍스트", "propertyIds": [ "샘플값" ], "viewSettings": { "key": "value" }, "ownerId": "MEM20260324090000ABCDEFGHIJKLMNO", "dateCreated": "2026-03-24T09:00:00.000Z", "dateUpdated": "2026-03-24T09:00:00.000Z" }