API

추적 키 생성

작성일 2026.03.24 | 수정일 2026.03.25

POST/crm-core/v1/tracking-keys

새로운 추적 키를 생성합니다. MEMBER 이상 권한이 필요합니다.

lightbulb

생성 시 반환되는 추적 키(rawKey)는 최초 1회만 확인할 수 있습니다.

이후에는 키의 접두사(keyPrefix)만 조회됩니다. 반드시 안전한 곳에 저장하세요.

Body Params

Name	Type	Required	Description
name	string	*	추적 키 이름 (최대 128자)
allowedDomains	Array<String>		허용 도메인 목록 (비어 있으면 모든 도메인 허용)
defaultEntityId	string		기본 개체 ID (SDK 요청 시 entityId 미지정 시 사용)
permissions	Object		권한 설정
createRecords	boolean		레코드 생성 허용 여부 (기본값: true)
trackEvents	boolean		이벤트 추적 허용 여부 (기본값: true)

Response

Name	Type	Required	Description
trackingKeyId	string	*	추적 키 고유 아이디
accountId	string	*	계정 고유 아이디
name	string	*	추적 키 이름
rawKey	string	*	추적 키 원본 (최초 1회만 반환, 형식: tk_live_xxx)
keyPrefix	string	*	키 접두사 (표시용)
allowedDomains	Array<String>		허용 도메인 목록
defaultEntityId	string		기본 개체 ID
permissions	Object	*	권한 설정
createRecords	boolean	*	레코드 생성 허용 여부
trackEvents	boolean	*	이벤트 추적 허용 여부
isActive	boolean	*	활성 상태
dateCreated	date	*	최초 생성 날짜
dateUpdated	date	*	최근 수정 날짜

Structure

Request Structure

{
  "name": "샘플",
  "allowedDomains": [
    "샘플값"
  ],
  "defaultEntityId": "ID_SAMPLE_12345",
  "permissions": {
    "createRecords": true,
    "trackEvents": true
  }
}

Response Structure

{
  "trackingKeyId": "TK20260324090000ABCDEFGHIJKLMNOP",
  "accountId": "24010100001234",
  "name": "샘플",
  "rawKey": "샘플값",
  "keyPrefix": "샘플값",
  "allowedDomains": [
    "샘플값"
  ],
  "defaultEntityId": "ID_SAMPLE_12345",
  "permissions": {
    "createRecords": true,
    "trackEvents": true
  },
  "isActive": true,
  "dateCreated": "2026-03-24T09:00:00.000Z",
  "dateUpdated": "2026-03-24T09:00:00.000Z"
}