API

추적 키 생성

작성일 2026.03.24 | 수정일 2026.04.14

POST/crm-core/v1/tracking-keys
새로운 추적 키를 생성합니다. MEMBER 이상 권한이 필요합니다.

lightbulb

생성 시 반환되는 추적 키(rawKey)는 **최초 1회만 확인**할 수 있습니다. 이후에는 키의 접두사(keyPrefix)만 조회됩니다. 반드시 **안전한 곳에 저장**하세요.

Body Params

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

Response

Name	Type	Description
trackingKeyId	string	추적 키 고유 아이디
accountId	string	계정 고유 아이디
name	string	추적 키 이름
rawKey	string	추적 키 원본 (최초 1회만 반환, 형식: tk_live_xxx)
keyPrefix	string	키 접두사 (표시용)
allowedDomains	Array	허용 도메인 목록
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"
}