Notion API 連接
透過 Notion 的 API,你將能夠建立自訂的內部連接。我們的某些合作夥伴可能也需要內部連接權杖,才能將他們的平台連結至你的 Notion 工作空間——下方我們將帶你一步步完成設定。
您可以從 Notion 管理個人存取權限。請從 設定 開啟開發人員模式,然後從側邊欄的開發人員區段開啟個人存取權限。請造訪我們的 開發人員中心 以取得說明文件、資源和連接管理工具。
提示: 工作空間擁有者可管理工作空間中的所有連接。進一步了解 企業版連接設定 →
正在尋找管理員權杖嗎?此頁面上的權杖適用於單一工作空間並處理頁面內容。如果您需要執行組織管理工作(例如匯出、法務保存或登出使用者),請參閱 企業版組織的管理員 API。
在左側側邊欄中,導覽至
設定,然後前往連接分頁。只有工作空間擁有者才能存取
連接分頁並建立整合。如果你不是管理員,請聯絡你的工作空間管理員或使用其他工作空間。請開啟 開發人員模式,然後從側邊欄的開發人員區段開啟個人存取權限。
按一下
+ 建立連接。為你的連接設定
名稱。你也可以選擇上傳一張圖片作為標誌。使用下拉式選單指定你想將此連接用於哪個
關聯的工作空間。
注意: 請確保你在網頁工作階段中登入 Notion 的帳號,與你在桌面版使用的帳號相同。否則,你將無法看到正確的帳號與工作空間!

你的內部連接已成功新增!現在你可以在工作空間的
設定選單 →連接中找到它。點擊內部連接旁的
•••以取得內部連接權杖。你在進行任何基於 API 的自動化或工作流程操作,或要將工作空間連結至某些合作夥伴平台時,都需要這個權杖。

注意: 內部連接是工作空間專屬的,因此若要變更關聯的工作空間,你必須建立新的連接。

所有新加入的連接最初都是內部連接。如果你正在開發公開連接,請先依照上述說明建立內部連接。
然後,請依照我們 開發人員指南 的指示,把它轉換為公開連接。
建立公開連接時,你可以選擇誰能安裝:
任何工作空間:任何人都能將你的連接安裝到自己的 Notion 工作空間。選定的工作空間:只有你列出的工作空間能安裝你的連接。
如果你只為自己的公司建置功能,不想讓其他組織安裝,請選擇 選定的工作空間。
每次有人安裝你的連接時,Notion 都會檢查對方的工作空間是否在你的列表中。如果不在,安裝就會中止,對方也會看到錯誤訊息。
只有任何人都能安裝的連接,才會列在連接庫中。僅限選定工作空間安裝的連接不會顯示在連接庫中。
提示:你會在建立連接時選擇這項設定。如果之後想改用其他設定,請建立新的連接。
你擁有的連接,會顯示在以下工作空間的開發者入口網站中:獲准安裝該連接、已安裝該連接,或是你用來建置該連接的工作空間。
每個公開連接都有一個用來建置和測試的工作空間。你可以切換到其他工作空間,不必從頭開始。
在開發者入口網站中開啟你的連接。
前往該連接的設定。
選取你要用來建置的工作空間。
Notion 會讓你的連接與所選工作空間建立連接。你不必建立新的連接。
在應用程式設定過程中,開發人員將能夠選擇使用者所需的存取層級。
內容功能:
僅讀取內容
僅寫入內容
插入內容
使用者功能
沒有使用者資訊
讀取使用者資訊(不包含使用者的電子郵件地址)
讀取使用者資訊(包含電子郵件)
當使用者安裝連接時,將會顯示此存取層級。它也會顯示在已新增該連接之任何頁面的 共用 選單中。進一步了解如何在工作空間中安裝連接 →
Webhook 連接讓連接能夠即時監控並回應 Notion 工作空間中的變更。
當與你的 連接 共享的頁面或資料庫發生變更時,Notion 會自動傳送通知到你的 Webhook 端點,讓該連接能立即更新其他工具、執行自動化任務或呈現最新變更。
如需操作說明,請造訪我們的 開發者文件。
Webhook 動作與 Webhook 連接有些相似之處——兩者都有觸發條件,且都能將事件傳送到第三方服務。然而,Webhook 連接提供了更廣泛的功能:
它們可以監控多個工作空間的活動。
它們可以處理無限數量的動作。
相比之下,Webhook 動作是為更簡單的使用案例所設計,並透過資料庫自動化進行設定,且觸發條件有限。
