Notion API 연결
Notion의 API를 사용하면 맞춤형 내부 연결을 생성할 수 있습니다. 일부 파트너는 자신의 플랫폼을 Notion 워크스페이스에 링크하려면 내부 연결 토큰이 필요할 수도 있습니다. 아래에서 이 설정 방법을 단계별로 안내해 드릴게요.
문서, 리소스, 연결 관리 도구를 보려면 개발자 허브 를 방문하세요.
참고: 워크스페이스의 모든 연결은 워크스페이스 소유자가 관리합니다. 자세히 알아보기 →
왼쪽 사이드바에서
설정을 선택한 다음연결탭으로 이동하세요.워크스페이스 소유자만
연결탭에 접근하고 통합을 생성할 수 있습니다. 관리자가 아닌 경우 워크스페이스 관리자에게 문의하거나 다른 워크스페이스를 사용하세요.하단에서
내 연결 개발하기링크를 클릭하세요.브라우저에서 내 연결이 열립니다.
+ 새로 만들기버튼을 클릭하세요.연결
이름을 지정하세요. 원하는 경우 이미지를 업로드하여로고로 사용할 수도 있습니다.드롭다운 메뉴에서 해당 연결을 사용하고자 하는
연결된 워크스페이스를 지정하세요.참고: 데스크톱에서 사용한 계정과 동일한 계정으로 웹에서 Notion에 로그인해야 합니다. 그렇지 않으면 올바른 계정과 워크스페이스가 표시되지 않습니다.
내부 연결이 성공적으로 추가되었습니다! 이제 워크스페이스의
설정 메뉴→연결에서 확인할 수 있습니다.내부 연결 토큰을 가져오려면 해당 내부 연결 옆의
•••을 클릭하세요. 이 토큰은 팀에서 생성하는 API 기반 자동화나 워크플로, 또는 워크스페이스를 일부 파트너 플랫폼에 링크할 때 필요합니다.
참고: 내부 연결은 워크스페이스별로 적용됩니다. 따라서 연결할 워크스페이스를 변경하기 위해서는 새 연결을 생성해야 합니다.
새로 추가되는 연결은 처음에는 내부 연결로 설정됩니다. 공용 연결을 개발하는 개발자라면, 위의 안내에 따라 먼저 내부 연결을 생성하세요.
그 다음, 개발자 가이드 의 설명에 따라 공개 연결로 전환할 수 있습니다.
API 통합을 설정하는 과정에서 사용자의 사용 권한을 지정할 수 있습니다.
콘텐츠 관련 권한
콘텐츠 읽기만 허용
콘텐츠 쓰기만 허용
콘텐츠 입력 허용
사용자 관련 권한
사용자 정보에 접근 불가
사용자 정보 읽기 허용(이메일 주소 제외)
사용자 정보 읽기 허용(이메일 포함)
사용자가 연결을 설치하면 이 사용 권한 수준이 표시됩니다. 또한, 연결이 추가된 페이지의 공유 메뉴에도 표시됩니다. 워크스페이스에 연결을 설치하는 방법 자세히 알아보기 →
연결 웹훅을 사용하면 연결을 통해 Notion 워크스페이스의 변경 사항을 실시간으로 모니터링하고 대응할 수 있습니다.
연결과 공유되는 페이지 또는 데이터베이스에 변경 사항이 발생하면 Notion은 웹훅 엔드포인트에 알림을 자동으로 전송하여 연결이 다른 도구를 즉시 업데이트하거나 자동화된 작업을 실행하거나 최신 변경 사항을 표시할 수 있도록 합니다.
연결 웹훅 설정
자세한 방법은 개발자 문서를 참고하세요.
현재 연결 웹훅은 다음에 대한 알림을 지원하지 않습니다.
사용자 변경(워크스페이스 멤버십 변경, 이메일/이름 업데이트, 권한 수정 포함)
워크스페이스 및 팀스페이스 설정 변경
이러한 유형의 알림의 경우 감사 로그를 사용하세요.
웹훅 작업과 연결 웹훅 비교
웹훅 작업과 연결 웹훅은 트리거를 가지고 있고 타사 서비스로 이벤트를 보낼 수 있다는 점에서 유사합니다. 하지만 연결 웹훅은 더 폭넓은 기능을 제공합니다.
여러 워크스페이스에서 활동을 모니터링할 수 있습니다.
개수 제한 없이 작업을 처리할 수 있습니다.
이와 반대로 웹훅 작업은 보다 간단한 사용 사례를 위해 설계되었으며 제한된 트리거 세트를 가진 데이터베이스 자동화를 통해 구성됩니다.
