채널 그룹 목록 조회
작성일 2026.03.07 | 수정일 2026.03.07
GET
/kakao/v2/channel-groupsQuery
channelGroupId— 채널 그룹 ID 필터링
channelIds— 채널 ID 필터링 (in 연산자 지원)
name— 그룹 이름 필터링 (eq, like 연산자 지원)
status— 상태 필터링 (PENDING, INSPECTING, APPROVED, REJECTED)
isMine— true이면 본인이 생성한 그룹만 조회
dateCreated— 생성 일시 필터 (eq, gte, lte, gt, lt 연산자 지원)
dateUpdated— 수정 일시 필터 (eq, gte, lte, gt, lt 연산자 지원)
startKey— 페이지네이션 시작 키
limit— 조회할 항목 수
chat
지원 연사자를 사용하실 경우 Query Operator 가이드를 참조하세요
본인이 소유하거나 참여 중인 채널 그룹 목록을 조회합니다.
상태, 이름, 생성일 등 다양한 필터를 조합하여 원하는 그룹만 검색할 수 있으며, 커서 기반 페이지네이션을 지원합니다.
대시보드에서 그룹 현황을 표시하거나, 특정 조건의 그룹을 일괄 관리할 때 활용합니다.
Response
채널 그룹 객체의 자세한 사항은 공통 응답 스키마를 참조해주세요
Structure
Response
{
"channelGroupList": [
{
"channelGroupId": "KA01GI00000001",
"accountId": "AC01000001",
"name": "마케팅 채널 그룹",
"channelIds": [
"CH01PF001",
"CH01PF002"
],
"type": "PRIVATE",
"status": "APPROVED",
"reasonCreated": "마케팅 캠페인용",
"reasonInspected": null,
"isBrand": false,
"dateCreated": "2024-01-01T00:00:00.000Z",
"dateUpdated": "2024-01-01T00:00:00.000Z"
}
],
"startKey": null
}