API

템플릿 추가

작성일 2026.03.07 | 수정일 2026.03.07

POST/kakao/v2/templates

새로운 알림톡 템플릿을 등록합니다.
등록된 템플릿은 카카오의 검수를 거쳐야 실제 발송에 사용할 수 있으며, 검수는 영업일 기준 1~3일 정도 소요됩니다.
channelId 또는 channelGroupId 중 하나를 지정하여 특정 채널이나 채널 그룹에 템플릿을 등록합니다.
템플릿 등록 후에는 템플릿 검수 요청TODO API를 통해 검수를 요청해야 합니다.

Body Params

NameTypeRequiredDescription
channelIdstring카카오톡 채널 고유 아이디. 채널에 템플릿을 등록하고 싶을 경우 필수입니다.
channelGroupIdstring카카오톡 채널 템플릿 그룹 고유 아이디. 그룹에 템플릿을 등록하고 싶을 경우 필수입니다.
namestring*템플릿 이름. 중복 가능합니다.
contentstring*템플릿 내용. 변수 포함 가능합니다. 변수 치환 후 1000자를 넘을 수 없습니다.
categoryCodestring*템플릿 카테고리 코드. 템플릿 카테고리 목록 조회 API로 확인 가능합니다.
buttonsarray버튼 목록
buttonTypestring*버튼 타입
buttonNamestring*버튼 이름
linkMostring모바일 링크
linkPcstringPC 링크
linkAndstring안드로이드 링크
linkIosstringiOS 링크
chatExtrastring상담톡/봇 전환 시 전달할 메타 정보
targetOutboolean아웃링크 사용 여부
quickRepliesarray바로연결 목록
messageTypestring메시지 유형 (BA: 기본형, EX: 부가정보형, AD: 채널추가형, MI: 복합형)
emphasizeTypestring강조 유형 (NONE: 선택안함, TEXT: 강조표기형, IMAGE: 이미지형, ITEM_LIST: 아이템리스트형)
headerstring헤더 (아이템리스트형에서 사용)
highlightobject하이라이트 (아이템리스트형에서 사용)
titlestring*하이라이트 제목
descriptionstring*하이라이트 설명
imageIdstring하이라이트 이미지 ID
itemobject아이템 리스트 (아이템리스트형에서 사용)
listarray*아이템 목록
titlestring*아이템 제목
descriptionstring*아이템 설명
summaryobject아이템 요약 정보
titlestring*요약 제목
descriptionstring*요약 설명
extrastring부가정보
adstring템플릿 내 수신동의요청 또는 간단 광고 문구
emphasizeTitlestring강조표기 핵심정보
emphasizeSubtitlestring강조표기 보조문구
securityFlagboolean보안 메시지 여부 (true일 경우 PC 미노출)
imageIdstring템플릿 이미지 ID