API

세그먼트 조회

작성일 2026.03.24 | 수정일 2026.03.25

GET/crm-core/v1/segments/:segmentId

Parameters

: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"
}