{"id":"460220b8-f6b5-4d2a-ba9a-8cecd4782876","task_name":"Add Connector - Notion","summary":"This workflow adds a Notion connector to Airbyte, enabling your AI agents to authenticate with Notion and access selected pages in real-time. You'll authorize Airbyte through Notion's OAuth flow, choose which pages to grant access to, and save the connector credential.","description":"Adds a Notion connector credential to Airbyte by authenticating a Notion account, selecting pages for access, and saving the connection.","tools_used":[],"agent_steps":[{"step_number":1,"action_type":"click","url":"https://app.airbyte.ai/organizations/07a090fe-ed68-49dd-832a-30cae2626178/get-started","element":{"name":"Credentials","role":"link","selector":"","xpath":"//html/body/div[2]/div/div[1]/div/nav/div/div[1]/ul/li[3]/a","attributes":{"href":"/organizations/07a090fe-ed68-49dd-832a-30cae2626178/credentials","data-testid":"credentialsLink"}},"value":"","keys":[],"file_paths":[],"description":"Navigate to the Credentials section in Airbyte by clicking the Credentials link in the top navigation. This is where you manage all connector authentications and API keys."},{"step_number":2,"action_type":"click","url":"https://app.airbyte.ai/organizations/07a090fe-ed68-49dd-832a-30cae2626178/credentials","element":{"name":"Add Credential","role":"button","selector":"","xpath":"//html/body/div[2]/div/div[1]/div/div/main/div/div/div[1]/div[2]/button","attributes":{"data-testid":"addCredentialButton"}},"value":"","keys":[],"file_paths":[],"description":"Click the 'Add Credential' button to begin creating a new connector credential. This opens a list of available connectors to authenticate."},{"step_number":3,"action_type":"click","url":"https://app.airbyte.ai/organizations/07a090fe-ed68-49dd-832a-30cae2626178/credentials","element":{"name":"Notion","role":"button","selector":"","xpath":"//html/body/div[10]/div[2]/div/div[2]/div/div[2]/button[29]","attributes":{"type":"button"}},"value":"","keys":[],"file_paths":[],"description":"Select 'Notion' from the available connectors. This initiates the Notion-specific authentication flow."},{"step_number":4,"action_type":"click","url":"https://app.airbyte.ai/organizations/07a090fe-ed68-49dd-832a-30cae2626178/credentials","element":{"name":"Authenticate your Notion account","role":"button","selector":"","xpath":"//html/body/div[12]/div/div/div/div[2]/div/div/div/form/div/div[2]/div/div/div[1]/div/div/button","attributes":{"type":"button","data-testid":"widget-oauth-button"}},"value":"","keys":[],"file_paths":[],"description":"Click the 'Authenticate your Notion account' button to begin the OAuth authorization process. This will redirect you to Notion's login and permission screen."},{"step_number":5,"action_type":"tab-switch","url":"","element":{"name":"","role":"","selector":"","xpath":"","attributes":{}},"value":"","keys":[],"file_paths":[],"description":"The browser automatically switches to the new Notion authentication tab. If the tab doesn't open automatically, check for browser pop-up blockers or manually switch to the Notion tab that appears."},{"step_number":6,"action_type":"navigate","url":"https://www.notion.so/install-integration?response_type=code&client_id=2d1ca561-f9c5-4a77-8ce8-18a583a7499e&redirect_uri=https%3A%2F%2Fapi.airbyte.com%2Fv1%2Foauth%2Fcallback&state=oDohQIz","element":{"name":"","role":"","selector":"","xpath":"","attributes":{}},"value":"","keys":[],"file_paths":[],"description":"You are now on Notion's website (www.notion.so) in the authentication flow. If you are not already logged in, Notion will prompt you to log in with your workspace credentials."},{"step_number":7,"action_type":"click","url":"https://www.notion.so/install-integration?response_type=code&client_id=2d1ca561-f9c5-4a77-8ce8-18a583a7499e&redirect_uri=https%3A%2F%2Fapi.airbyte.com%2Fv1%2Foauth%2Fcallback&state=oDohQIz","element":{"name":"Select pages","role":"button","selector":"","xpath":"//html/body/div/div/div/div[1]/div/div/div/div[2]/div/div[3]/div[2]","attributes":{}},"value":"","keys":[],"file_paths":[],"description":"Click the 'Select pages' button to view and choose which Notion pages Airbyte is allowed to access. This is a critical security step—only selected pages will be available to your agents."},{"step_number":8,"action_type":"type","url":"https://www.notion.so/install-integration?response_type=code&client_id=2d1ca561-f9c5-4a77-8ce8-18a583a7499e&redirect_uri=https%3A%2F%2Fapi.airbyte.com%2Fv1%2Foauth%2Fcallback&state=oDohQIz","element":{"name":"Search pages","role":"textbox","selector":"","xpath":"//html/body/div/div/div/div[1]/div/div/div/div[2]/div/div[1]/div/div[3]/div[2]/div/div/div/div/div/div/input","attributes":{"type":"text","placeholder":"Search pages"}},"value":"","keys":[],"file_paths":[],"description":"Use the 'Search pages' text field to filter and locate specific pages in your Notion workspace. Type the page name or keyword to narrow the list if you have many pages."},{"step_number":9,"action_type":"click","url":"https://www.notion.so/install-integration?response_type=code&client_id=2d1ca561-f9c5-4a77-8ce8-18a583a7499e&redirect_uri=https%3A%2F%2Fapi.airbyte.com%2Fv1%2Foauth%2Fcallback&state=oDohQIz","element":{"name":"Teamspaces","role":"button","selector":"","xpath":"//html/body/div/div/div/div[1]/div/div/div/div[2]/div/div[1]/div/div[3]/div[3]/div/div/div[1]/div/div","attributes":{}},"value":"","keys":[],"file_paths":[],"description":"Click on 'Teamspaces' (or the specific workspace/collection folder name) to expand and view pages within that section of your Notion workspace. This helps you navigate the page hierarchy."},{"step_number":10,"action_type":"click","url":"https://www.notion.so/install-integration?response_type=code&client_id=2d1ca561-f9c5-4a77-8ce8-18a583a7499e&redirect_uri=https%3A%2F%2Fapi.airbyte.com%2Fv1%2Foauth%2Fcallback&state=oDohQIz","element":{"name":"","role":"checkbox","selector":"","xpath":"//html/body/div/div/div/div[1]/div/div/div/div[2]/div/div[1]/div/div[3]/div[3]/div/div/div[1]/div[2]/div/div/div/div/div[2]/div/div[1]/div/input","attributes":{"type":"checkbox"}},"value":"","keys":[],"file_paths":[],"description":"Check the checkbox next to each page you want to grant Airbyte access to. You can select multiple pages—only the checked pages will be accessible to your agents."},{"step_number":11,"action_type":"click","url":"https://www.notion.so/install-integration?response_type=code&client_id=2d1ca561-f9c5-4a77-8ce8-18a583a7499e&redirect_uri=https%3A%2F%2Fapi.airbyte.com%2Fv1%2Foauth%2Fcallback&state=oDohQIz","element":{"name":"Allow access","role":"button","selector":"","xpath":"//html/body/div/div/div/div[1]/div/div/div/div[2]/div/div[2]/div[2]","attributes":{}},"value":"","keys":[],"file_paths":[],"description":"Click the 'Allow access' button to confirm your page selections and grant Airbyte permission to access the chosen pages in your Notion workspace. This completes Notion's OAuth authorization."},{"step_number":12,"action_type":"click","url":"https://www.notion.so/install-integration?response_type=code&client_id=2d1ca561-f9c5-4a77-8ce8-18a583a7499e&redirect_uri=https%3A%2F%2Fapi.airbyte.com%2Fv1%2Foauth%2Fcallback&state=oDohQIz","element":{"name":"","role":"link","selector":"","xpath":"//html/body/a","attributes":{"href":"https://api.airbyte.com/v1/oauth/callback?code=03cbdea4-42b8-42f0-8c55-efed35c46206&state=oDohQIz"}},"value":"","keys":[],"file_paths":[],"description":"Notion displays a confirmation or callback link that redirects you back to Airbyte. Click this link (or allow the automatic redirect) to return to Airbyte and complete the credential setup."},{"step_number":13,"action_type":"navigate","url":"https://app.airbyte.ai/auth_flow?code=03cbdea4-42b8-42f0-8c55-efed35c46206&state=oDohQIz","element":{"name":"","role":"","selector":"","xpath":"","attributes":{}},"value":"","keys":[],"file_paths":[],"description":"The browser navigates back to app.airbyte.ai and displays the credential summary, showing your authenticated Notion account and the pages you selected."},{"step_number":14,"action_type":"click","url":"https://app.airbyte.ai/organizations/07a090fe-ed68-49dd-832a-30cae2626178/credentials","element":{"name":"Save","role":"button","selector":"","xpath":"//html/body/div[12]/div/div/div/div[3]/div/div/button","attributes":{"type":"button"}},"value":"","keys":[],"file_paths":[],"description":"Click the 'Save' button to persist the Notion connector credential in Airbyte. The credential is now available for use in agent connections and workflows."}]}