API

이벤트 추적

작성일 2026.03.24 | 수정일 2026.03.25

POST/crm-core/v1/sdk/events

SDK를 통해 이벤트를 추적합니다.

chat

TrackingKey 인증 방식을 사용합니다. 요청 제한은 분당 600건입니다.

Body Params

Name	Type	Required	Description
recordId	string	*	레코드 ID
eventType	string	*	이벤트 유형 (최대 128자)
entityId	string		개체 ID (미지정 시 TrackingKey 기본값 사용)
category	string		카테고리 (최대 128자)
label	string		라벨 (최대 512자)
value	number		값
properties	Object		추가 속성
occurredAt	date		발생 일시 (미지정 시 현재 시각)

Response

Name	Type	Required	Description
eventId	string	*	이벤트 고유 ID
recordId	string	*	레코드 ID
eventType	string	*	이벤트 유형
dateCreated	date	*	생성 날짜

Structure

Request Structure

{
  "recordId": "REC20260324090000ABCDEFGHIJKLMNO",
  "eventType": "PURCHASE",
  "entityId": "ENT20260324090000ABCDEFGHIJKLMNO",
  "category": "general",
  "label": "라벨",
  "value": 100,
  "properties": {
    "key": "value"
  },
  "occurredAt": "2026-03-24T09:00:00.000Z"
}

Response Structure

{
  "eventId": "EVT20260324090000ABCDEFGHIJKLMNO",
  "recordId": "REC20260324090000ABCDEFGHIJKLMNO",
  "eventType": "PURCHASE",
  "dateCreated": "2026-03-24T09:00:00.000Z"
}