API

채널 그룹 생성

작성일 2026.03.07 | 수정일 2026.03.07

POST/kakao/v2/channel-groups

카카오톡 채널 그룹을 새로 생성합니다.
채널 그룹은 여러 채널을 하나로 묶어 동일한 템플릿을 공유할 수 있게 해주는 기능으로, 다수의 브랜드나 지점을 운영하는 경우에 유용합니다.
그룹 생성 후에는 관리자가 직접 연동처에 그룹 생성 요청을 해야 합니다.

Body Params

NameTypeRequiredDescription
channelIdsarray*그룹에 포함할 채널 ID 목록 (2개 이상 필수)
namestring*그룹 이름
reasonCreatedstring*그룹 생성 사유

chat

채널 그룹 객체를 반환합니다. 공통 응답 스키마를 참조해주세요.

Structure

Request
{ "channelIds": [ "CH01PF001", "CH01PF002" ], "name": "마케팅 채널 그룹", "reasonCreated": "마케팅 캠페인을 위한 채널 그룹 생성" }
Response
{ "channelGroupId": "KA01GI00000001", "accountId": "AC01000001", "name": "마케팅 채널 그룹", "channelIds": [ "CH01PF001", "CH01PF002" ], "type": "PRIVATE", "status": "PENDING", "reasonCreated": "마케팅 캠페인을 위한 채널 그룹 생성", "reasonInspected": null, "isBrand": false, "dateCreated": "2024-01-01T00:00:00.000Z", "dateUpdated": "2024-01-01T00:00:00.000Z" }