노션 API 키 발급 안돼 자동화 멈출 때 해결법

노션 api key 발급 방법을 검색하다가 화면을 껐다가 다시 들어갔더니 키가 사라져서 당황하고 계신 상황, 겪어보셨을 겁니다. 자동화 연동을 위해 키를 복사하려고 했던 순간, 노션이 보안상의 이유로 키를 가려버리거나 재발급이 불가능해 보여서 작업이 완전히 멈춰버렸을 것입니다. 이 문제는 노션이 통합 토큰을 생성한 직후에만 한 번 보여주고, 이후에는 다시 조회할 수 없도록 설계했기 때문에 발생합니다. 이 글에서는 키를 잃어버렸을 때 당황하지 않고 바로 대처하는 방법부터, 자동화 툴과 연동할 때 가장 많이 하는 실수와 해결책까지 단계별로 알려드립니다.

함께 보면 좋은 글: 노션 템플릿 수정 방법 — 팀 페이지에 맞게 바로 적용

노션 API 키 발급이 안 되는 정확한 원인 진단

많은 사용자가 API 키 발급 버튼을 눌렀을 때 나오는 'Internal Integration Token'을 복사하지 않고 창을 닫았다가, 다시 돌아와서 키를 찾지 못해 난감해합니다. 노션의 공식 개발자 문서에 따르면, 보안 정책상 사용자가 생성한 통합 토큰은 생성 시점에 딱 한 번만 전체 문자열을 보여주도록 설계되어 있습니다. 이는 마치 비밀번호를 생성한 뒤 즉시 숨기는 것과 같은 메커니즘입니다. 사용자의 입장에서는 소프트웨어의 오류로 느껴질 수 있지만, 이는 노션이 채택하고 있는 보안 모델(Security Model)의 핵심적인 부분으로, 키가 탈취될 가능성을 원천적으로 차단하기 위한 조치입니다.

따라서 "발급이 안 된다"기보다는 "이미 발급되었지만 다시 볼 수 없는 상태"입니다. 만약 키를 복사하지 않았다면, 해당 키는 영구적으로 조회가 불가능하며 이를 해결하는 유일한 방법은 기존 통합을 삭제하고 처음부터 다시 생성하는 과정을 거쳐야 합니다. 이 과정을 모르는 사용자는 계속해서 같은 페이지에서 새로고침을 하거나 버튼을 눌러보며 멈춰 버립니다. 마치 이미 나간 비밀번호를 다시 보여달라고 요청하는 것과 같아서, 시스템적으로는 불가능한 요청이기 때문입니다.

또한, 단순히 키를 복사했다고 끝이 아니라는 점도 원인 파악에 중요합니다. 한 가지 더 흔한 경우는 키는 발급받았지만, 해당 키를 사용하려는 페이지나 데이터베이스에 이 통합 앱이 연결되지 않아서 작동하지 않는 경우입니다. 키가 자물쇠라면, 페이지 연결은 열쇠를 꽂는 행위와 같으므로 두 가지 모두 완료되어야만 비로소 자동화가 작동합니다. 이러한 2단계 인증 과정(키 발급 + 권한 부여)을 이해하지 못하면 "키는 있는데 왜 안 되지?"라는 의문을 갖게 되며, 이는 실제로 권한 설정 누락에서 오는 문제일 확률이 매우 높습니다.

이 외에도 노션의 업데이트나 UI 변경으로 인해 메뉴의 위치가 바뀌어 발급 버튼을 찾지 못하는 경우도 있습니다. 과거에는 'Developers' 항목 하위에 있던 메뉴가 최신 버전에서는 'My Integrations'로 통합되었거나, 워크스페이스 설정의 깊숙한 곳으로 이동된 경우도 있으니, 현재 사용 중인 노션 버전과 화면 구성을 다시 한번 꼼꼼히 확인해 볼 필요가 있습니다.

Photo by Beyzanur K. on Pexels

해결책 1. 노션 api key 발급 방법 재확인 및 재생성

가장 확실한 해결책은 기존에 실패한 통합을 과감하게 삭제하고 다시 만드는 것입니다. 키를 분실했을 때 되돌릴 수 있는 방법은 없으므로, 새로운 키를 발급받는 절차를 숙지해야 합니다. 아래 단계를 차근차근 따라 하면 1분 내에 새로운 키를 확보할 수 있습니다. 이 과정은 단순히 버튼을 누르는 것을 넘어, 어떤 권한이 필요한지 정확히 파악하여 향후 보안 사고를 예방하는 기회가 될 수 있습니다.

이 과정을 통해 새로운 키를 확보했다면, 이제 이 키가 실제로 작동하는지 테스트해볼 수 있습니다. 터미널이나 코드 에디터를 사용하는 경우, 아래와 같이 curl 명령어를 통해 간단히 연결 상태를 확인할 수 있습니다. 이 테스트는 복잡한 코드를 작성하기 전, 인증 정보가 정확한지 빠르게 검증하는 가장 좋은 방법입니다.

curl -X POST https://api.notion.com/v1/pages \
  -H 'Authorization: Bearer [YOUR_API_KEY]' \
  -H 'Content-Type: application/json' \
  -H 'Notion-Version: 2022-06-28' \
  --data '{
    "parent": { "database_id": "[DATABASE_ID]" },
    "properties": {
      "Name": {
        "title": [
          {
            "text": {
              "content": "API Test Page"
            }
          }
        ]
      }
    }
  }'

위 명령어에서 [YOUR_API_KEY]와 [DATABASE_ID]만 본인의 환경에 맞게 수정하여 실행하면, 노션 데이터베이스에 새로운 페이지가 생성되는지 확인할 수 있습니다. 만약 이 단계에서 401 Unauthorized 오류가 발생한다면 키가 잘못되었거나 권한 설정에 문제가 있는 것입니다.