NAVER WORKS Developers : Community

Content

Q&A

Community

네이버웍스를 사용하는 모든 개발자가 유용한 팁과 문제 해결법을 공유할 수 있는 공간입니다.

??dev_메인_타이틀_모바일_ko_KR??

API

최신순

이상진_24426b

Refresh Token Rotation 사용 시 Refresh Token 유효기간(90일)이 갱신 때마다 새로 시작되는지 문의

구성원 계정 OAuth(Authorization Code)로 Drive·Mail API를 쓰고 있습니다. 개발자 콘솔에서 Refresh Token Rotation을 On으로 두었고, Access Token을 갱신할 때마다 응답으로 온 새 Refresh Token을 저장해 다음 갱신에 쓰고 있습니다. 문서(인증 > OAuth)에는 Refresh Token 유효기간이 90일이고 Rotation On이면 갱신 시 새 Refresh Token이 발급된다고 되어 있는데, 아래 내용은 찾지 못해 문의드립니다. 1. Rotation으로 새로 받은 Refresh Token은 그 토큰이 발급된 시점부터 다시 90일인가요? 아니면 계속 갱신해 왔더라도 최초 동의 시점에서 90일이 지나면 만료되나요? 2. 최초 동의 시점 기준으로 만료된다면, 사용자가 다시 로그인·동의하지 않고 연결을 유지하는 방법이 있나요? 3. Refresh Token이 "Client ID +

2026.10.27읽음 84

좋아요 0 0
최지우_1d6575

클로바 노트쪽 공유받은 노트 목록 및 상세 조회 api 추가 계획은 없으신가요?

https://developers.worksmobile.com/kr/docs/ainote-user-note-list https://developers.worksmobile.com/kr/docs/ainote-user-note-get 내 노트의 목록 및 상세 조회는 api 제공되는것 같은데요. 공유받은 노트 목록 조회 및 상세 조회도 제공되었으면 좋겠습니다. 감사합니다.

2026.09.01읽음 289

좋아요 2 0
박형렬_b23829

다른 회사(테넌트) 네이버웍스에 로그인된 브라우저에서 OAuth authorize 호출 시 "유효하지 않은 클라이언트 정보입니다" 오류 — redirect_uri 로 돌려받을 방법이 있나요?

안녕하세요. 자사 테넌트(ourcompany.com)에 등록한 앱으로 사내 어드민의 네이버웍스 로그인(OAuth 2.0 Authorization Code + OIDC)을 구현해 운영 중입니다. 정상 상황에서는 잘 동작하는데, 특정 조건에서 네이버웍스 오류 페이지에 갇혀 저희 서비스로 돌아오지 못하는 문제가 있어 문의드립니다. ■ 요청 URL https://auth.worksmobile.com/oauth2/v2.0/authorize?client_id=XXXXXXXXXXXXXXXXXXXX&redirect_uri=https%3A%2F%2Fadmin.ourcompany.com%2Fapi%2Fauth%2Fworks%2Fcallback&response_type=code&scope=openid%20email%20profile&state=…&nonce=… (redirect_uri 는 Developer Console 에 등록된 값과 정확히

2026.08.24읽음 418

좋아요 0 1
푸딩코딩맨

프로젝트 api 언제쯤 지원되나요? MCP 제공 계획은 없나요?

개발팀 내부에서 클로드코드와 연계하여 프로젝트 관리를 하려고 하는데 아직까지 프로젝트 Open API가 없네요. (이게 요즘같은 AI 시대에 이렇게 오래걸릴 일인가 의문입니다) 물론 네이버웍스의 MCP 까지는 기대하기 어렵겠죠? 커뮤니티 내에 이미 동일한 문의가 있던데 답변이 없어 재문의 드립니다.

2026.08.20읽음 1504

좋아요 5 1
jwgmi_35de80

결재 서비스 API 권한 관련 문의

안녕하세요, businessSupport.approval.read scope로 GET /business-support/approval/users/{userId}/documents는 성공하며, 해당 사용자는 웹 UI에서도 해당 문서를 열람할 수 있습니다. 하지만 같은 목록에서 반환된 approvalDocumentId로 GET /business-support/approval/documents/{approvalDocumentId} 호출 시 403 FORBIDDEN이 발생합니다. 상세 조회 API에 구성원 열람권한 외 추가 권한 또는 관리자 권한이 필요한가요? 확인 부탁드립니다.

2026.08.11읽음 301

좋아요 0 0
darby

구성원 계정으로 인증 방식을 통해 토큰을 받으면 해당 계정이 접근 가능한 채팅방만 접근이 가능한가요?

안녕하세요. 구성원 계정으로 인증 방식을 통해 토큰을 받으면 API를 통해 메시지 내용을 크롤링 할 때 해당 계정이 원래 접근 가능한 채팅방만 접근이 가능한가요? 접근이 없는 채팅방은 크롤링을 할 수 없는게 맞나요? 사내 보안을 유지하기 위해 여쭙습니다.

2026.08.10읽음 344

좋아요 0 2
마리오_a643ce

그룹에 초대된 Bot(Service Account)의 그룹 노트 API 호출 허용 요청 — 403 "Not allowed api"

안녕하세요. 사내 업무 자동화 봇을 운영 중인 개발사입니다. 【현상】 Service Account(JWT) 방식으로 발급한 액세스 토큰으로 그룹 노트 게시글 목록 API를 호출하면 403이 반환됩니다. 호출: GET https://www.worksapis.com/v1.0/groups/{groupId}/note/posts 응답: {"code":"FORBIDDEN","description":"Not allowed api"} 【확인한 사항】 토큰 발급 응답의 scope 필드에 group.note.read가 포함되어 있음을 확인했습니다 (scope 미부여 문제 아님). 같은 토큰으로 GET /groups(group.read)는 200 정상 동작하며, groupId도 이 응답에서 얻은 정확한 값입니다. 해당 Bot은 문제의 그룹(대화방)에 멤버로 초대되어 있어 메시지 콜백 수신·전송이 정상 동작합니다. 동일

2026.07.21읽음 363

좋아요 0 2
황배익_32520e

프로젝트의 API

프로젝트 기능의 API도 업데이트가 될 예정일까요? 프로젝트기능은 클로바인 기능이 흡수된것 같은데 너무 좋아요.

2026.07.08읽음 316

좋아요 0 0
웍스개발_96299a

Task(할일) 관련 API 요청 문의

작성하신 내용은 누구나 볼 수 있습니다. 계정 이름, 도메인 이름, Client ID, Client Secret 등의 비공개 정보는 기입하지마세요. 문의 카테고리에 Task(할일) 관련 항목이 없어 API로 문의 드립니다. 제가 할일 목록을 가져오기위해 우선 카테고리 목록을 아래 API를 통해 가져오려고 했는데, https://developers.worksmobile.com/kr/docs/user-task-category-list 응답이 403 Fobidden으로 나오네요 개발자콘솔에서 해당 앱의 권한에 task, task.read 를 모두 추가한 상태입니다. 다음의 URL을 통해 요청한 상태이고, url = f"https://www.worksapis.com/v1.0/users/{user_email}/task-categories" 사용자ID 부분에 user_email을 넣었습니다. ※ 이메일이 아닌 사용자 ID(example : userf7da-f82c-4284-1

2026.06.26읽음 354

좋아요 0 1
suwon.lee

설비(회의실 등) 예약 상태 조회/등록/삭제/수정 API 관련

현재 설비(회의실 등), 예약 관련 API가 지원되지 않는 것으로 파악하고 있습니다. 그나마 일정 API에서 location 은 확인할 수 있으나, API 자체가 사용자 기준이기에, 도메인 전체에서 예약 현황 등을 파악하려면 일정 API로는 제한적이며, 규모가 큰 경우 사용자가 너무 많아 매우 번거롭습니다. https://developers.worksmobile.com/kr/docs/calendar#attendees-and-resource 설비 관련 API를 제공해주시길 요청드리며, 사용자만이 아니라 도메인이나 조직 기준으로 설비를 파악할 수 있도록 기능일 제공해주시면 좋겠습니다. Bot 등을 통해 네이버웍스 일정/회의를 등록하고자 하는데, 현재의 API로는 우회하는 방법 밖에 없고, 이 마저도 상당히 번거로워 이용에 제한적이오니 긍정적인 검토를 부탁드립니다.

2026.06.17읽음 340

좋아요 1 0
열랑_c7e205

프로젝트 API 관련

프로젝트의 제목, 내용, 댓글, 상태 등의 정보를 API로 조회 할 수 있는 기능을 제공하나요? 제공하지 않으면 제공 할 계획이 있나요? 제공하면 언제쯤 가능 할 까요?

2026.04.16읽음 609

좋아요 5 0
구수한_ee03b4

네이버웍스 드라이브 API 조회

작성하신 내용은 누구나 볼 수 있습니다. 계정 이름, 도메인 이름, Client ID, Client Secret 등의 비공개 정보는 기입하지마세요. OAuth Scopes: file.read 체크 완료 토큰 발급 성공하지만 /v1.0/sharedrives 호출 시 403 Developer Console에서 "관리자 권한으로 앱 사용" 같은 설정이 보이지 않음 어떤 설정이 추가로 필요한가요?

2026.04.06읽음 720

좋아요 0 1
신진형_5b22b4

결재 문서 상세 조회 API

"결재 문서 상세 조회 API(GET /v1.0/approval/docs/{docId}) 응답에 첨부파일 다운로드 URL이 포함되나요? 또는 첨부파일 다운로드 전용 API endpoint가 있나요?"

2026.04.01읽음 476

좋아요 0 0
단팥빵_56924d

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

안녕하세요. 네이버웍스 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 h

2026.03.26읽음 921

좋아요 0 1
초보초보

구성원 정보를 받아올 때 hiredDate 정보가 다 null로 나옵니다.

혹시 따로 설정을 해줘야 그 정보도 받아올 수 있는 걸까요?

2026.03.25읽음 487

좋아요 0 1
하하하

네이버웍스 드라이브 API를 이용한 파일업로드/다운로드 문의

네이버웍스 드라이브를 무료체험으로 신청하여 테스트 중입니다. API를 이용하여 파일목록조회, 링크생성등의 기능은 확인 하였으나 파일 업로드/다운로드를 할 경우는 아래와 같은 응답이 리턴됩니다. { "code": "UNAUTHORIZED", "description": "Authentication failed." } 토큰 발급시 scope는 file,file.read를 지정하였습니다. 어떤 것을 더 확인해봐야 할까요?

2026.03.25읽음 999

좋아요 0 1
김수민_eb950d

유효하지않은 클라이언트 정보

안녕하세요. 네이버웍스 Open API를 활용하여 메일 발송 기능을 개발 중인데, OAuth 2.0 인증 과정에서 문제가 발생하여 문의드립니다. 문제 현상 인증URL을 접속하면 "유효하지 않은 클라이언트 정보" 오류 페이지가 표시됩니다. 확인한 사항 Client ID / Client Secret: 개발자 콘솔과 일치 확인 Redirect URI: 콘솔에 동일하게 등록되어 있음 앱 유형: OAuth 2.0 Scope: mail 활성화 확인 앱 상태: 활성화 확인 위 사항을 모두 확인하였음에도 동일한 오류가 지속되고 있습니다. 해당 앱 또는 계정에 인증을 제한하는 설정이 있는지, 혹은 별도의 활성화 절차가 필요한지 확인 부탁드립니다. 감사합니다.

2026.03.11읽음 829

좋아요 0 1
Dong joon Par_ec1b46

메세지 api 여부

메시지를 불러와서 읽을수 있는 api 가 없어 보이는데 가능한지 알고 싶네요.

2026.02.19읽음 547

좋아요 0 1
대박날김팀장

API Invalid client information 오류 원인 요청

유효하지 않은 클라이언트 정보입니다. Client Id 또는 Parameter를 확인해 주세요. Developer Console 정상적으로 다 등록했는데 해당 페이지가 계속 리다이렉트 되고 있습니다.

2026.02.19읽음 719

좋아요 0 1
김정다라다

메일 발송 시 첨부파일의 다운로드 기간은 설정할 수 없나요?

안녕하세요. API명세상 메일 읽기에는 첨부된 파일 기한에 따라 다운로드 가능한 기능이 제공되는 것으로 보입니다. 메일 발송시에는 첨부파일의 다운로드 기한을 설정할 수 없는 것처럼 보이는데, 해당 기능은 제공하지 않으시는걸까요?

2026.01.27읽음 899

좋아요 0 1