세그먼트 조회
작성일 2026.03.24 | 수정일 2026.04.14
GET/crm-core/v1/segments/:segmentIdParameters:segmentId— 세그먼트 고유 아이디
특정 세그먼트의 상세 정보를 조회합니다.
세그먼트 조건의 fieldType이 'EVENT'인 경우, eventConfig 객체로 이벤트 기반 조건을 설정할 수 있습니다. eventConfig에는 eventType(이벤트 타입), aggregation(COUNT 또는 SUM), timeWindow(시간 윈도우) 등을 지정합니다.
Response
| Name | Type | Required | Description |
|---|---|---|---|
| segmentId | string | 세그먼트 고유 아이디 | |
| accountId | string | 계정 고유 아이디 | |
| entityId | string | 개체 ID | |
| name | string | 세그먼트 이름 | |
| description | string | 세그먼트 설명 | |
| color | string | 색상 코드 | |
| conditions | Object | 조건 그룹 | |
| ownerId | string | 세그먼트 소유자 멤버 ID | |
| isActive | boolean | 활성화 여부 | |
| dateCreated | date | 최초 생성 날짜 | |
| dateUpdated | date | * | 최근 수정 날짜 |
Structure
Response Structure⎘{
"segmentId": "SEG20260324090000ABCDEFGHIJKLMNO",
"accountId": "24010100001234",
"entityId": "ENT20260324090000ABCDEFGHIJKLMNO",
"name": "샘플",
"description": "설명 텍스트",
"color": "샘플값",
"conditions": {
"key": "value"
},
"ownerId": "MEM20260324090000ABCDEFGHIJKLMNO",
"isActive": true,
"dateCreated": "2026-03-24T09:00:00.000Z",
"dateUpdated": "2026-03-24T09:00:00.000Z"
}