API

레코드 생성

작성일 2026.03.24 | 수정일 2026.03.25

POST/crm-core/v1/records

새로운 CRM 레코드를 생성합니다. MEMBER 이상 권한이 필요합니다.

chat

레코드 생성 시 요금제의 레코드 수 제한(records.max)이 적용됩니다.

Body Params

Name	Type	Required	Description
entityId	string	*	개체 ID
name	string	*	레코드 이름
data	Object		레코드 데이터 (속성 ID를 키로 사용)
tags	Array<String>		태그 목록
links	Object		연결 목록 (키: 링크 유형, 값: ID 배열)
ownerId	string		레코드 소유자 멤버 ID

Response

Name	Type	Required	Description
recordId	string	*	레코드 고유 ID
accountId	string	*	계정 고유 ID
entityId	string	*	개체 ID
name	string	*	레코드 이름
data	Object		레코드 데이터
tags	Array<String>		태그 목록
links	Object		연결 목록
ownerId	string		소유자 멤버 ID
dateCreated	date	*	최초 생성 날짜
dateUpdated	date	*	최근 수정 날짜

Structure

Request Structure

{
  "entityId": "ENT20260324090000ABCDEFGHIJKLMNO",
  "name": "샘플",
  "data": {
    "propertyId1": "value1",
    "propertyId2": "value2"
  },
  "tags": [
    "샘플값"
  ],
  "links": {
    "linkType": [
      "TYPE_SAMPLE"
    ]
  },
  "ownerId": "MEM20260324090000ABCDEFGHIJKLMNO"
}

Response Structure

{
  "recordId": "REC20260324090000ABCDEFGHIJKLMNO",
  "accountId": "24010100001234",
  "entityId": "ENT20260324090000ABCDEFGHIJKLMNO",
  "name": "샘플",
  "data": {
    "key": "value"
  },
  "tags": [
    "샘플값"
  ],
  "links": {
    "key": "value"
  },
  "ownerId": "MEM20260324090000ABCDEFGHIJKLMNO",
  "dateCreated": "2026-03-24T09:00:00.000Z",
  "dateUpdated": "2026-03-24T09:00:00.000Z"
}