API

채널 그룹 수정

작성일 2026.03.07 | 수정일 2026.03.07

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

Parameters

channelGroupId— 채널 그룹 고유 ID

기존 채널 그룹의 정보를 수정합니다.
현재는 그룹 이름 변경을 지원합니다. 검수 대기(PENDING) 또는 반려(REJECTED) 상태의 그룹만 수정할 수 있으므로, 승인된 그룹의 이름을 바꾸려면 별도 절차가 필요합니다.

Body Params

Name	Type	Required	Description
name	string		변경할 그룹 이름

chat

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

Structure

Request

{
  "name": "새로운 그룹 이름"
}

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-02T00:00:00.000Z"
}