네이버웍스 API 2.0 OAuth 인증 후 메일 폴더 조회 시 403 &#39;Mail does not exist&#39; 오류 문의

API

2026.03.26읽음 7

안녕하세요.

네이버웍스 API 2.0을 활용하여 메일 연동 개발 중 문제가 발생하여 문의드립니다.

■ 환경 정보

- Domain ID: *****

- 사용 플랜: Standard (메일 66GB 사용 중)

- 인증 방식: OAuth 2.0 (Authorization Code Grant Flow)

- 조회 대상 계정: *****

■ 설정 완료 사항

- Developer Console에서 앱 등록 완료

- OAuth Scopes: mail, mail.read, bot, calendar, user 모두 체크 완료

- Redirect URI: http://localhost:5000/callback 등록 완료

- Private Key 재발급 완료

- OAuth 2.0 인증 및 Access Token 발급 성공 확인

■ 문제 현상

OAuth 인증 및 Access Token 발급은 정상적으로 성공하였으나,

메일 폴더 목록 조회 API 호출 시 아래 오류가 발생합니다.

- 요청 URL: GET https://www.worksapis.com/v1.0/users/b***o/mail/folders

- 응답 상태코드: 403

- 응답 메시지: "Mail does not exist."

■ 확인한 사항

- 캘린더 API (GET /v1.0/calendars)는 동일한 인증 방식으로 정상 작동 확인

- 해당 계정은 메일을 66GB 이상 정상 사용 중

- userId를 이메일 전체(b***o@**********nage.co.kr)와 로컬 파트(b***o) 모두 시도하였으나 동일 오류 발생

■ 문의 사항

1. OAuth 2.0 방식으로 메일 API를 사용하기 위해 추가로 필요한 설정이 있는지요?

2. "Mail does not exist" 오류의 정확한 원인과 해결 방법을 알고 싶습니다.

3. 서비스 계정(JWT) 방식으로는 메일 API 사용이 구조적으로 불가능한지, 가능하다면 어떤 추가 설정이 필요한지 안내 부탁드립니다.

빠른 답변 부탁드립니다.

감사합니다.

좋아요! 0

NAVER WORKS