API

레코드 생성

작성일 2026.03.24 | 수정일 2026.04.14

POST/crm-core/v1/records

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

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

Body Params| Name | Type | Required | Description |

| ------ | ------ | ------ | ------ | | entityId | string | | 개체 ID | | name | string | | 레코드 이름 | | data | Object | | 레코드 데이터 (속성 ID를 키로 사용) | | tags | Array\ | | 태그 목록 | | ownerId | string | | 레코드 소유자 멤버 ID |## Response| | Name | Type | Required | Description | | ------ | ------ | ------ | ------ | | recordId | string | | 레코드 고유 ID | | accountId | string | | 계정 고유 ID | | entityId | string | | 개체 ID | | name | string | | 레코드 이름 | | data | Object | | 레코드 데이터 | | tags | Array\ | | 태그 목록 | | ownerId | string | | 소유자 멤버 ID | | dateCreated | date | | 최초 생성 날짜 | | dateUpdated | date | | 최근 수정 날짜 |## Structure ``

json Request Structure
{
  "entityId": "ENT20260324090000ABCDEFGHIJKLMNO",
  "name": "샘플",
  "data": {
    "propertyId1": "value1",
    "propertyId2": "value2"
  },
  "tags": ["샘플값"],
  "ownerId": "MEM20260324090000ABCDEFGHIJKLMNO"
}
json Response Structure
{
  "recordId": "REC20260324090000ABCDEFGHIJKLMNO",
  "accountId": "24010100001234",
  "entityId": "ENT20260324090000ABCDEFGHIJKLMNO",
  "name": "샘플",
  "data": {
    "key": "value"
  },
  "tags": ["샘플값"],
  "ownerId": "MEM20260324090000ABCDEFGHIJKLMNO",
  "dateCreated": "2026-03-24T09:00:00.000Z",
  "dateUpdated": "2026-03-24T09:00:00.000Z"
}