카카오모먼트 v4 API 호출 시 -401 에러 및 KOE205 발생 문의

카카오모먼트 API에 대한 최신 공지는 카카오모먼트 공지사항카카오광고 통합 에이전시 에서 확인 가능합니다.

카카오모먼트 API 외 문의사항은 DevTalk 각 카테고리나 FAQ에서 확인 가능합니다. 카카오모먼트 오픈API 외 자주 발생하는 문의는 아래 게시판에서 확인 및 등록 가능합니다.

︎- AdFit SDK FAQ
︎- AdFit SDK 고객센터 문의
︎- 픽셀&SDK FAQ 1
︎- 픽셀&SDK 고객센터 문의

카카오모먼트 오픈API 권한이 없는 앱, 카카오모먼트 오픈API가 아닌 다른 문의의 경우 답변이 늦어지거나 진행이 불가하오니 이 점 양해 부탁드립니다.

※ 사용 중 문의사항은 아래 내용을 기재하신 후 작성해주시길 바랍니다.
호출 시 발생한 오류의 경우 호출 /응답 내용을 상세히 남겨주시는 것이 확인 및 답변에 도움이 됩니다.

  • 사업자명: (주)광고온

  • APP 이름(ID): 광고 데이터 로봇 (1441931)

  • 문의 내용: 본 문의는 카카오모먼트 오픈 API 사용 중 발생한 권한/인증 이슈입니다.

    • 카카오모먼트 오픈 API 심사: 승인 완료

1. 환경 정보

- 디벨로퍼스 앱 ID: 1441931

- 역할 등급: Editor

- 비즈앱: 등록 완료

- 카카오모먼트 추가 기능 심사: 승인 완료

- 비즈니스 인증 페이지: moment_management ‘사용 가능’ 표시됨

- 허용 IP 설정: 비어있음

2. 발생 현상

[현상 1] 광고계정 조회 시 -401

호출 URL: GET https://apis.moment.kakao.com/openapi/v4/adAccounts

요청 헤더:

Authorization: Bearer

(※ 토큰: GET /v2/user/me 200 OK 정상 발급, 만료 전)

응답:

HTTP 401

Body: {“msg”:“target biz token is not supplied.”,“code”:-401}

확인 사항:

- 토큰 owner (카카오 ID 마스킹: 489***942) 는 다음 광고계정의 마스터/멤버 권한 보유 확인:

• 861\*\*\* (마스터, 자사 광고계정)

• 435\*\*\* 외 5개 (멤버, 직원별 광고계정)

※ 정확한 광고계정 ID 는 카카오 담당자께 비공개 채널 (DM 또는 이메일) 로 별도 전달 가능합니다.

- 동일 토큰으로 adAccountId 헤더 명시한 다른 endpoint 도 모두 401 동일 응답

[현상 2] scope=moment_management 명시 시 KOE205

인증 요청 URL 의 scope 파라미터에 moment_management 명시 시 KOE205 발생.

에러: Unset consent item(s): moment_management

3. 콘솔 확인 사항

- [제품 설정] > [카카오 로그인] > [동의항목]: moment_management 항목 미노출

- [제품 설정] > [비즈니스 인증]: moment_management ‘사용 가능’ 표시 (설정 버튼 없음)

- Editor 권한이라 마스터 전용 메뉴는 직접 접근 불가

4. 질문

(1) scope=moment_management 가 동의항목 UI 에 노출되려면 어떤 절차가 선행되어야 하나요?

사업자 인증 외 추가 매핑/연동 단계가 필요하다면 구체적 메뉴 경로 안내 부탁드립니다.

(2) ‘target biz token’ 의 정확한 의미와 공급 방법은 무엇인가요?

별도 토큰 발급이 필요하다면 그 절차의 문서 페이지 안내 부탁드립니다.

(3) 비즈니스 인증 페이지의 ‘moment_management 사용 가능’ 상태와

동의항목 페이지의 'moment_management 미노출' 상태가 동시에 가능한가요?

두 페이지의 관계와 정상 상태가 어떤 형태인지 설명 부탁드립니다.

답변 부탁드립니다.

안녕하세요.

혹시, 카카오로그인으로 발급받은 액세스토큰으로 API 호출하셨나요?

모먼트 API는 비즈니스 인증으로 광고계정이용하여 비즈니스 토큰 발급 받아 사용하셔야합니다.

동일한 OAuth2 방식 인증이며 Endpoint가 다릅니다.

가이드 확인 부탁드려요.