API

발송 가능 브랜드 템플릿 목록 조회

작성일 2026.03.09 | 수정일 2026.03.24

GET/kakao/v2/brand-templates/sendable

Query

pfId— 플러스친구 아이디로 필터

brandTemplateId— 특정 브랜드 템플릿 아이디로 필터

현재 계정에서 실제 발송에 사용할 수 있는 브랜드 템플릿 목록을 조회하는 API로, 메시지 발송 전 사용 가능한 템플릿을 확인하거나 발송 화면의 템플릿 선택 목록을 구성할 때 활용합니다.

조회 시 codes 배열에 ACTIVE 상태의 코드가 존재하는 템플릿만 반환되며, isDeleted: true인 템플릿은 자동으로 제외됩니다. 또한 계정에 속한 채널(pfId)과 해당 채널이 속한 그룹(pfGroupId) 기준으로 모두 조회되므로, 채널 단위 및 그룹 단위 템플릿이 함께 포함됩니다.

chat

페이지네이션 없이 조건에 맞는 전체 브랜드 템플릿을 배열로 반환합니다.
각 항목의 자세한 사항은 공통 응답 스키마를 참고하세요.