13편에서 페이지 공유와 권한 설정을 다뤘습니다. 이번에는 노션 밖으로 나가는 법을 다룹니다. 노션 API로 노션을 구글 캘린더 같은 외부 서비스와 연결하는 기초입니다. 노션 안에만 있던 할 일과 일정이 외부 서비스와 이어지면, 노션은 기록장이 아니라 허브가 됩니다. 오늘은 API가 무엇인지, 연동을 시작하는 순서, 구글 캘린더와 연결하는 세 가지 길, 처음 해볼 만한 작은 자동화까지 정리합니다.
1. 노션 API란 — 노션 밖에서 노션을 움직이는 통로
노션 API는 노션 데이터베이스와 페이지를 외부 프로그램에서 읽고 쓸 수 있게 해주는 공식 통로입니다. 개발자용이지만, 개념만 알면 비개발자도 자동화 도구를 통해 쓸 수 있습니다. API를 쓰면 할 일을 캘린더로 보내거나, 폼 응답을 데이터베이스에 쌓는 식의 연결이 됩니다. 핵심은 두 가지입니다. 노션 쪽에 이 외부 연결을 믿는다는 허락(통합)을 만들고, 그 허락에 딸린 열쇠(토큰)로 요청을 보내는 것입니다.
2. 연동 시작하기 — 통합 만들고 데이터베이스에 초대하기
연동은 노션 개발자 포털에서 연결(예전 이름은 통합)을 만드는 것부터 시작합니다. 2026년부터 개발자 포털이 노션 앱 안으로 들어와서, 노션의 설정 → 연결에서 ‘연결 개발 또는 관리’를 열거나 app.notion.com/developers/connections로 접속합니다. 예전 주소인 notion.so/my-integrations로 들어가도 이 화면으로 자동 이동합니다. ‘내부 연결’에서 새 연결을 만들고(워크스페이스 소유자만 만들 수 있습니다), 이름은 용도를 알 수 있게 정합니다. 예를 들어 “캘린더 연동”처럼 적습니다. 만들면 구성(Configuration) 탭에서 API 토큰이 발급됩니다. 이 토큰은 비밀번호와 같으니 다른 사람에게 보이지 않게 보관합니다. 다음으로 연결할 데이터베이스나 페이지를 열어 ••• 메뉴의 연결 추가에서 만든 연결을 초대합니다. 사람을 초대하는 것과 같은 방식입니다. 초대가 안 된 데이터베이스는 API로 열리지 않으니, 연결이 안 될 때는 초대 여부를 먼저 확인합니다.
3. API가 하는 일 — 검색, 조회, 만들기, 고치기
API로 할 수 있는 기본 동작은 네 가지입니다. 검색으로 페이지나 데이터베이스를 찾고, 데이터베이스를 조회해 행 목록을 가져오고, 페이지를 새로 만들고, 기존 페이지 내용을 고칩니다. 요청을 보낼 때는 버전 정보(Notion-Version 헤더)를 함께 보냅니다. 2026년 11월 기준 최신 버전은 2026-03-11입니다. 한 번에 너무 많은 요청을 보내면 제한에 걸리니, 요금제에 따라 달라지는 요청 제한을 확인하고 천천히 보내는 것이 좋습니다. 처음에는 조회만으로 시작해 읽기가 되는지 확인한 뒤에 쓰기를 더하는 순서가 안전합니다.
4. 구글 캘린더와 연결하는 세 가지 길
가장 쉬운 길은 노션 캘린더 앱입니다. 노션 캘린더는 구글 캘린더와 바로 연결돼, 구글 일정이 노션 캘린더 화면에 함께 보입니다. 노션에 적어 둔 일정과 구글 일정을 한 화면에서 볼 수 있습니다. 두 번째 길은 자동화 도구입니다. Zapier나 Make 같은 도구에서 “노션 데이터베이스에 새 행이 생기면 구글 캘린더에 일정을 만든다”는 흐름을 정하면, 코드를 쓰지 않고도 연결됩니다. 세 번째 길은 API를 직접 쓰는 것입니다. 노션 API로 마감일이 있는 행을 읽고, 구글 캘린더 API로 일정을 만드는 방식입니다. 손은 많이 가지만 원하는 대로 세밀하게 정할 수 있습니다. 처음이라면 노션 캘린더 앱부터, 반복되는 일을 줄이고 싶다면 자동화 도구부터 시작하는 것이 좋습니다.
5. 처음 해볼 만한 작은 자동화 — 마감일을 캘린더로 옮기기
예 하나를 정해 보겠습니다. 노션 할 일 데이터베이스에 마감일이 있는 행이 있습니다. 이 행이 생기거나 마감일이 바뀌면 구글 캘린더에 일정이 만들어집니다. 자동화 도구에서는 시작 조건을 “데이터베이스에 새 행 추가”로 정하고, 보낼 값을 제목과 마감일로 고릅니다. 캘린더 일정 제목에는 노션 행 제목을 그대로 넣고, 날짜는 마감일을 넣습니다. 이렇게 한 번만 흐름을 만들어 두면, 그 뒤로는 노션에 적는 것만으로 캘린더가 채워집니다. 반대로 캘린더 일정을 노션으로 가져오는 흐름도 같은 방식으로 만들 수 있습니다.
6. 연동할 때 조심할 것 — 열쇠 관리와 권한 범위
토큰은 비밀번호와 같습니다. 코드나 공유 문서에 그대로 적지 말고, 환경 변수나 비밀 저장소에 둡니다. 토큰이 새면 통합 설정에서 바로 폐기하고 새로 만듭니다. 두 번째로 권한 범위입니다. 통합은 초대한 데이터베이스와 페이지만 볼 수 있습니다. 워크스페이스 전체가 열리는 것이 아니니, 연결할 데이터베이스만 초대하는 것이 안전합니다. 마지막으로 동기화는 만능이 아닙니다. 양쪽을 동시에 고치면 어느 쪽이 최신인지 헷갈릴 수 있으니, 처음에는 한쪽 방향으로만 흐르게 정해 두는 것이 좋습니다. 잘 돌아가는 것을 확인한 뒤에 양방향으로 넓힙니다.
마무리
노션 API는 거창한 기술이 아닙니다. 통합을 만들고, 데이터베이스에 초대하고, 읽고 쓰는 요청을 보내는 순서가 전부입니다. 구글 캘린더와 이어 쓰면 노션에 적힌 할 일이 일정이 되고, 일정이 다시 노션 기록이 됩니다. 오늘은 노션 캘린더 앱부터 연결해 보고, 반복되는 일이 보이면 자동화 도구로 한 걸음만 더 나아가 보세요. 다음 편에서는 노션을 쓰며 초보자가 흔히 하는 실수 다섯 가지와 데이터를 안전하게 백업하는 법을 다룹니다.
노션 시리즈 모아보기
- 1편 — 노션(Notion)이란? 초보자가 당장 시작해야 하는 3가지 이유
- 2편 — 노션 기본 화면 구성과 시간을 단축해 주는 필수 단축키 완벽 정리
- 3편 — 노션 블록 활용법 — 텍스트·이미지·북마크 블록과 깔끔한 레이아웃 나누기
- 4편 — 노션 페이지 계층 구조 이해하기 — 폴더 대신 페이지로 관리하는 법
- 5편 — 노션 데이터베이스 기초 — 표(Table)와 보드(Board) 만들기
- 6편 — 노션 데이터베이스 속성 완벽 이해 — 태그, 날짜, 파일 첨부
- 7편 — 노션 데이터베이스 뷰 전환 — 캘린더·갤러리 뷰 100% 활용법
- 8편 — 노션 관계형·롤업 속성으로 흩어진 데이터 연결하기
- 9편 — 노션 템플릿 복사하고 내 입맛대로 완벽하게 수정하는 방법
- 10편 — 노션 데이터베이스 필터와 정렬로 원하는 정보만 골라 보는 법
- 11편 — 노션으로 나만의 독서 기록장(Reading Tracker) 페이지 만들기
- 12편 — 노션 웹 클리퍼로 인터넷 정보 수집하고 깔끔하게 정리하는 법
- 13편 — 노션 페이지 외부 공유 및 안전하게 권한 설정하는 완벽 가이드