API

세그먼트 목록 조회

작성일 2026.03.24 | 수정일 2026.03.25

GET/crm-core/v1/segments

Query

entityId— 개체 ID로 필터링

세그먼트 목록을 조회합니다.

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