CHAPTER 01
노션 API 연동이 막막하게 느껴지는 이유
노션 API 키 발급 연동을 처음 시도하면 용어부터 낯설게 느껴지죠. 'API가 뭔지', '인테그레이션은 어디서 만드는지', '발급받은 키를 어디에 입력해야 하는지' — 검색해도 설명이 파편적이라 중간에 막히기 쉬운 주제입니다.
💬 "Make에서 노션 연동을 하려는데 API 토큰을 어디서 받아야 하는지 모르겠어요."
💬 "인테그레이션을 만들었는데 페이지에 어떻게 연결하는지 헷갈려요."
💬 "내부 통합이랑 공개 통합이 뭐가 다른지 모르겠어요."
노션 API의 역할부터 내부 통합·공개 통합의 차이, 키 발급, 페이지 연결, 실전 활용 예시까지 순서대로 설명해드릴테니 차근차근히 따라해보세요. 개발 지식 없이도 5분 만에 쉽게 하실 수 있어요.
CHAPTER 02
내부 통합 vs 공개 통합 — 노션 API 구축 방식 2가지
노션 API 키를 발급받는 방법은 두 가지입니다. 만들기 전에 어떤 방식이 내 상황에 맞는지 먼저 파악하는 것이 중요한데요.
내부 통합 (Internal Integration)
내부 통합은 특정 워크스페이스 내부에서만 작동하는 연동 방식입니다. 발급받은 API 키(토큰)를 Make·Zapier 같은 자동화 툴이나 직접 작성한 코드에 입력해 사용합니다. 개인 업무 자동화, 팀 내부 데이터 연동, 노션 데이터베이스 관리에 가장 많이 쓰이는 방식입니다.
💡 Make·Zapier 자동화가 목적이라면 내부 통합으로 생성하시면 됩니다.
공개 통합 (Public Integration)
공개 통합은 다른 사용자의 노션 워크스페이스에도 연결될 수 있도록 만드는 방식입니다. OAuth 인증을 사용하기 때문에, 노션 연동 기능을 제공하는 SaaS 서비스나 외부 배포용 앱을 개발할 때 선택합니다. 설정이 복잡하고 노션의 검토 절차가 필요하며, 일반적인 개인·팀 자동화 목적에는 필요하지 않습니다.
접근 범위
내 워크스페이스만
다른 사용자 워크스페이스도 가능
인증 방식
토큰(API 키) 직접 입력
OAuth 2.0 인증 흐름
설정 난이도
쉬움 — 5단계면 완료
복잡 — 개발 지식 필요, 노션 검토 필요
주요 사용처
Make, Zapier, 개인 스크립트
노션 연동 SaaS·앱 개발
이 글에서는 대부분의 사용자에게 해당하는 내부 통합 방식을 기준으로 API 키 발급 과정을 알려드릴게요.
CHAPTER 03
노션 API 키 발급 방법 — 인테그레이션 5단계
노션 API가 하는 역할
노션 API는 노션 데이터를 외부 서비스와 주고받을 수 있도록 연결해주는 통로입니다. API 키(토큰)는 "이 워크스페이스에 접근할 권한이 있다"는 것을 증명하는 비밀번호 같은 값입니다. Make, Zapier, Google 시트, 직접 코드 작성 등 어떤 방식이든 노션 데이터를 읽거나 쓰려면 이 키가 반드시 필요합니다.
노션 API 키 발급 단계별 방법
노션 API 키는 노션 인테그레이션(Integration)을 만들면서 함께 발급받습니다. 아래 순서를 따라하세요.
② New integration
왼쪽 구축 > 내부 API 통합 > '새 API 통합 만들기' 또는 'New integration' 버튼을 클릭합니다.
③ 기본 정보 입력
원하는 'API 통합 이름'을 입력해주세요.
API를 연동할 '관련 워크스페이스'를 선택해줍니다.
④ 권한 설정
생성하기 클릭 > API 통합 설정 구성을 클릭해주세요.
그럼 아직 어떤 사용 권한을 부여하지 않아 어떤 페이지에도 접근할 수 없는 상태가 되는데요.
상단 콘텐츠 사용 권한으로 이동해 생성한 API가 접근할 수 있는 페이지를 편집 권한을
눌러서 선택해주세요.
⑤ 토큰 복사
구성 탭에서 프라이빗 API 통합 시크릿 값을 복사합니다. 이 값이 바로 노션 API 키입니다. 외부에 노출되지 않도록 안전하게 보관하세요.
💡 토큰이 마스킹되어 있다면 'Show' 또는 '표시하기' 버튼을 클릭해야 전체 값이 표시됩니다. 한 번 창을 닫으면 다시 가려지므로, 복사 후 메모 앱에 안전하게 저장해두세요.
CHAPTER 04
노션 API 연동 후 활용하는 실전 방법 3가지
이렇게 API 설정 페이지에서 사용하고 싶은 노션 페이지에 인테그레이션을 직접 연결할 수도 있지만 페이지를 만들다가 연결하고 싶은 페이지에서 직접 연결하는 방법도 있습니다.
노션 페이지에 인테그레이션 연결하기
연결하고 싶은 노션 페이지 또는 데이터베이스를 엽니다. 우측 상단의 ··· (더보기) 메뉴를 클릭한 뒤 'Connect to' 또는 '연결' 을 선택하면 방금 만든 인테그레이션이 목록에 나타납니다. 클릭해서 연결하면 이제 해당 페이지를 API로 읽고 쓸 수 있습니다.
노션 API 키 활용 예시 3가지
노션 API 연동을 마쳤다면 다양한 방식으로 자동화와 데이터 연동을 구현할 수 있습니다.
🔗 Make · Zapier
코딩 없이 자동화가 가능합니다. API 키를 Make·Zapier의 Notion 모듈에 입력하면 데이터베이스에 행 자동 추가·수정·조회가 됩니다. Gmail 수신 시 노션에 자동 기록하는 방식이 대표적입니다.
📊 구글 시트 연동
노션 데이터베이스를 구글 시트로 동기화해 보고서·통계 작업에 활용할 수 있습니다. Make를 중간 연결 도구로 사용하는 방식이 일반적입니다.
💻 직접 코드 작성
Python·JavaScript로 Notion API를 직접 호출해 데이터를 읽고 씁니다. 공식 노션 SDK(notion-client)를 사용하면 더 편리하게 구현할 수 있습니다.
✍️ TODOTO Editor's Note
저희 팀은 Make와 노션 API를 연동해 고객 문의가 접수될 때 노션 데이터베이스에 자동으로 행을 추가하는 운영 방식으로 업무를 하고 있는데요. 무엇보다 접수가 되었는지 일일히 확인하지 않아도 되고 자동으로 데이터베이스가 쌓이니 너무 편하더라구요. 다만 API 키는 필요한 권한만 최소화해서 발급하는 것이 보안상 안전하고, 모든 자동화 시나리오가 노션 API만으로 해결되는 것은 아니라는 점도 참고해주세요.
TODOTO 실제 사용 경험
CHAPTER 05
노션 API, 자주 묻는 질문 모음
❓ 자주 묻는 질문
Q. 노션 API 키 발급은 유료인가요?
A. 무료로 발급받을 수 있습니다. 노션 무료 플랜 사용자도 인테그레이션을 생성하고 API 키를 발급받아 사용할 수 있습니다.
Q. 내부 통합과 공개 통합 중 어떤 것을 선택해야 하나요?
A. Make·Zapier 자동화나 개인·팀 내부 용도라면 내부 통합을 선택하세요. 공개 통합은 다른 사용자의 워크스페이스와도 연결되는 서비스·앱을 개발할 때만 필요하며, 설정이 복잡하고 노션의 검토 절차가 따릅니다.
Q. 인테그레이션을 페이지에 연결하지 않으면 어떻게 되나요?
A. API 호출 시 권한 오류가 발생합니다. 노션 API는 페이지별 연결이 필수입니다. API 키를 발급받았더라도 각 페이지에 인테그레이션을 연결해야 접근이 가능합니다.
Q. API 키를 분실했을 때는 어떻게 하나요?
A. notion.so/my-integrations 에서 해당 인테그레이션을 선택한 뒤 Secrets 탭에서 새 토큰을 재발급받을 수 있습니다. 새 토큰 발급 후 기존 토큰은 자동으로 만료됩니다.
Q. Make에서 노션 API 연동 시 토큰은 어디에 입력하나요?
A. Make에서 Notion 모듈을 추가하면 'Create a connection' 창이 뜹니다. Internal Integration Token 항목에 발급받은 API 키를 붙여넣으면 연동이 완료됩니다.
노션 API 키 발급 연동,
이제 직접 해볼 차례예요!
내부 통합과 공개 통합의 차이를 파악하고, 인테그레이션 생성부터 페이지 연결, 자동화 활용까지 순서대로 따라하면 충분히 해낼 수 있습니다.
노션 실력을 더 키우고 싶다면 아래 가이드를 참고해보세요.
노션 사용법 완전 정복 가이드 바로가기 →
노션 API 연동이 막막하게 느껴지는 이유
노션 API 키 발급 연동을 처음 시도하면 용어부터 낯설게 느껴지죠. 'API가 뭔지', '인테그레이션은 어디서 만드는지', '발급받은 키를 어디에 입력해야 하는지' — 검색해도 설명이 파편적이라 중간에 막히기 쉬운 주제입니다.
💬 "Make에서 노션 연동을 하려는데 API 토큰을 어디서 받아야 하는지 모르겠어요."
💬 "인테그레이션을 만들었는데 페이지에 어떻게 연결하는지 헷갈려요."
💬 "내부 통합이랑 공개 통합이 뭐가 다른지 모르겠어요."
노션 API의 역할부터 내부 통합·공개 통합의 차이, 키 발급, 페이지 연결, 실전 활용 예시까지 순서대로 설명해드릴테니 차근차근히 따라해보세요. 개발 지식 없이도 5분 만에 쉽게 하실 수 있어요.
내부 통합 vs 공개 통합 — 노션 API 구축 방식 2가지
노션 API 키를 발급받는 방법은 두 가지입니다. 만들기 전에 어떤 방식이 내 상황에 맞는지 먼저 파악하는 것이 중요한데요.
내부 통합 (Internal Integration)
내부 통합은 특정 워크스페이스 내부에서만 작동하는 연동 방식입니다. 발급받은 API 키(토큰)를 Make·Zapier 같은 자동화 툴이나 직접 작성한 코드에 입력해 사용합니다. 개인 업무 자동화, 팀 내부 데이터 연동, 노션 데이터베이스 관리에 가장 많이 쓰이는 방식입니다.
공개 통합 (Public Integration)
공개 통합은 다른 사용자의 노션 워크스페이스에도 연결될 수 있도록 만드는 방식입니다. OAuth 인증을 사용하기 때문에, 노션 연동 기능을 제공하는 SaaS 서비스나 외부 배포용 앱을 개발할 때 선택합니다. 설정이 복잡하고 노션의 검토 절차가 필요하며, 일반적인 개인·팀 자동화 목적에는 필요하지 않습니다.
이 글에서는 대부분의 사용자에게 해당하는 내부 통합 방식을 기준으로 API 키 발급 과정을 알려드릴게요.
노션 API 키 발급 방법 — 인테그레이션 5단계
노션 API가 하는 역할
노션 API는 노션 데이터를 외부 서비스와 주고받을 수 있도록 연결해주는 통로입니다. API 키(토큰)는 "이 워크스페이스에 접근할 권한이 있다"는 것을 증명하는 비밀번호 같은 값입니다. Make, Zapier, Google 시트, 직접 코드 작성 등 어떤 방식이든 노션 데이터를 읽거나 쓰려면 이 키가 반드시 필요합니다.
노션 API 키 발급 단계별 방법
노션 API 키는 노션 인테그레이션(Integration)을 만들면서 함께 발급받습니다. 아래 순서를 따라하세요.
API를 연동할 '관련 워크스페이스'를 선택해줍니다.
그럼 아직 어떤 사용 권한을 부여하지 않아 어떤 페이지에도 접근할 수 없는 상태가 되는데요.
상단 콘텐츠 사용 권한으로 이동해 생성한 API가 접근할 수 있는 페이지를 편집 권한을
눌러서 선택해주세요.
노션 API 연동 후 활용하는 실전 방법 3가지
이렇게 API 설정 페이지에서 사용하고 싶은 노션 페이지에 인테그레이션을 직접 연결할 수도 있지만 페이지를 만들다가 연결하고 싶은 페이지에서 직접 연결하는 방법도 있습니다.
노션 페이지에 인테그레이션 연결하기
연결하고 싶은 노션 페이지 또는 데이터베이스를 엽니다. 우측 상단의 ··· (더보기) 메뉴를 클릭한 뒤 'Connect to' 또는 '연결' 을 선택하면 방금 만든 인테그레이션이 목록에 나타납니다. 클릭해서 연결하면 이제 해당 페이지를 API로 읽고 쓸 수 있습니다.
노션 API 키 활용 예시 3가지
노션 API 연동을 마쳤다면 다양한 방식으로 자동화와 데이터 연동을 구현할 수 있습니다.
✍️ TODOTO Editor's Note
저희 팀은 Make와 노션 API를 연동해 고객 문의가 접수될 때 노션 데이터베이스에 자동으로 행을 추가하는 운영 방식으로 업무를 하고 있는데요. 무엇보다 접수가 되었는지 일일히 확인하지 않아도 되고 자동으로 데이터베이스가 쌓이니 너무 편하더라구요. 다만 API 키는 필요한 권한만 최소화해서 발급하는 것이 보안상 안전하고, 모든 자동화 시나리오가 노션 API만으로 해결되는 것은 아니라는 점도 참고해주세요.
TODOTO 실제 사용 경험
노션 API, 자주 묻는 질문 모음
❓ 자주 묻는 질문
Q. 노션 API 키 발급은 유료인가요?
A. 무료로 발급받을 수 있습니다. 노션 무료 플랜 사용자도 인테그레이션을 생성하고 API 키를 발급받아 사용할 수 있습니다.
Q. 내부 통합과 공개 통합 중 어떤 것을 선택해야 하나요?
A. Make·Zapier 자동화나 개인·팀 내부 용도라면 내부 통합을 선택하세요. 공개 통합은 다른 사용자의 워크스페이스와도 연결되는 서비스·앱을 개발할 때만 필요하며, 설정이 복잡하고 노션의 검토 절차가 따릅니다.
Q. 인테그레이션을 페이지에 연결하지 않으면 어떻게 되나요?
A. API 호출 시 권한 오류가 발생합니다. 노션 API는 페이지별 연결이 필수입니다. API 키를 발급받았더라도 각 페이지에 인테그레이션을 연결해야 접근이 가능합니다.
Q. API 키를 분실했을 때는 어떻게 하나요?
A. notion.so/my-integrations 에서 해당 인테그레이션을 선택한 뒤 Secrets 탭에서 새 토큰을 재발급받을 수 있습니다. 새 토큰 발급 후 기존 토큰은 자동으로 만료됩니다.
Q. Make에서 노션 API 연동 시 토큰은 어디에 입력하나요?
A. Make에서 Notion 모듈을 추가하면 'Create a connection' 창이 뜹니다. Internal Integration Token 항목에 발급받은 API 키를 붙여넣으면 연동이 완료됩니다.
👉 노션을 더 잘 쓰고 싶다면?
노션 API 키 발급 연동,
이제 직접 해볼 차례예요!
내부 통합과 공개 통합의 차이를 파악하고, 인테그레이션 생성부터 페이지 연결, 자동화 활용까지 순서대로 따라하면 충분히 해낼 수 있습니다.
노션 실력을 더 키우고 싶다면 아래 가이드를 참고해보세요.
노션 사용법 완전 정복 가이드 바로가기 →