API

채널 그룹 조회

작성일 2026.03.07 | 수정일 2026.03.07

GET/kakao/v2/channel-groups/:channelGroupId

Parameters

channelGroupId— 채널 그룹 고유 ID

특정 채널 그룹의 상세 정보를 조회합니다. 그룹에 속한 채널들의 상세 정보(channels)도 함께 반환되므로, 그룹 구성 현황을 한눈에 파악할 때 사용합니다. 본인 소유 그룹이거나 본인 채널이 포함된 그룹만 조회할 수 있습니다.

Response

공통 응답 스키마 - 채널 그룹 객체의 모든 필드에 추가로 channels 필드가 포함됩니다.

Name	Type	Required	Description
channels	array	*	채널 상세 정보 목록 (phoneNumber, sharedAccountIds 제외)

Structure

{
  "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",
  "channels": [
    {
      "channelId": "CH01PF001",
      "searchId": "@channel1",
      "name": "채널1"
    },
    {
      "channelId": "CH01PF002",
      "searchId": "@channel2",
      "name": "채널2"
    }
  ]
}