1. How does SQAI Suite Leverage This Integration?
Connecting to Notion allows SQAI to integrate your organization's knowledge base into the QA workflow:
Contextual Accuracy: SQAI reads your technical specifications, documentation, and requirements directly from selected Notion pages.
Knowledge Grounding: Prevents SQAI from using generic information, ensuring all output is grounded in your organization's specific documented knowledge.
Selective Training: You maintain full control over exactly which top-level page SQAI has read access to.
2. Complementary Value: SQAI Suite and Notion AI
Notion offers powerful native AI capabilities focused on content creation, summarizing, and internal knowledge structuring. SQAI Suite is highly complementary, specializing in transforming that clean, organized knowledge into structured, executable QA assets delivered to external tools.
Focus Area | Notion AI Contribution | SQAI Suite Contribution |
Input/Context | Content Creation: Summarizes pages, drafts content, and organizes databases within Notion. | Context Aggregation: Consumes the organized Notion content and synthesizes it with real-time data from Jira, code repos (GitLab, GitHub), and other integrated TMTs. |
Output/Delivery | Internal Workflow: Improves the quality and structure of documentation living inside the Notion workspace. | QA Artifact Delivery: Uses the documentation context to generate and push high-quality, executable artifacts (e.g., test cases, Playwright scripts, automated data) into external systems (e.g., BrowserStack, Azure DevOps, Bitbucket). |
By combining the strengths of Notion's content quality with SQAI's contextual generation engine, your team ensures that all testing efforts are driven by the most accurate and up-to-date documentation.
3. Information Required from Your Notion Account
For the Notion integration, only a single credential is required: a dedicated Internal Integration Secret (API Key).
Required Detail | Explanation | How to Find It |
API Key / Secret | The secret token generated when you create a new Internal Integration in Notion. | See Section 4. |
4. Setting up the Integration (Notion Internal Integration)
The most crucial step is generating a secure Internal Integration and then granting it permission to read specific pages in your workspace.
Step 1: Create a New Internal Integration
In Notion, navigate to Settings & Members (found in the sidebar).
Select Integrations. You can also navigate directly to:
https://www.notion.so/profile/integrationsClick the New Integration card
Fill in the integration details:
Integration Name: (e.g.,
SQAI Suite Integration).Associated workspace: Select your target workspace.
Type: Select Internal.
Set the Capabilities permissions:
Under Content Capabilities, check Read content .
Under User Capabilities, check No user information.
Click Save.
Step 2: Retrieve the Internal Integration Secret (API Key)
After saving, you will be taken to the Configuration tab.
The Internal Integration Secret is displayed. Click Show and then Copy the secret. This is your API Key.
Step 3: Grant Access to Pages/Databases
The integration cannot read any pages until you explicitly share them with it in your main workspace.
In your main Notion workspace, navigate to the top-level page or database you want SQAI to read.
Click the ... (three dots) menu in the top right corner of the page.
Click Add connections and search for the SQAI Suite Integration you just created.
Alternatively, go back to the Integrations list, select the SQAI Integration, and click the Access tab.
Click Edit access
Search for the top-level pages/databases (e.g., "WORK" or "Biome") and check the box to grant read access.
Click Update access.
5. Entering Details in SQAI Suite
Once you have secured your API Key and granted access to the required pages, you can complete the setup in the SQAI Suite platform.
Step 1: Navigate to Integrations Go to your SQAI Suite settings and select the Integrations page. Find and select the Notion configuration.
Step 2: Enter Details Insert the following detail into the corresponding field:
API Key (The Secret from the Internal Integration)
Experiation Date (Optional, in case you like notifications)
Step 3: Save and Confirm Click "Save Configuration." If the set-up is successful, you will receive a success message and see a green indicator next to your Notion integration.
6. Troubleshooting Notion Integration
If SQAI reports an error or fails to connect, use this checklist to quickly identify and resolve the most common issues related to access and data retrieval.
Problem | Cause | Solution |
Connection Failed: "Unauthorized" or "Access Denied" | A. Invalid API Key: The Internal Integration Secret was copied incorrectly or has been revoked. | Verify Secret: Re-copy the Secret from the Integration's configuration tab and ensure it is entered accurately into SQAI Suite. |
SQAI Connects, But Cannot Find Content | B. Missing Page Access: The integration exists, but it has not been granted read access to the specific pages/databases you are referencing. | Grant Access: Navigate to the specific top-level page in Notion and ensure the SQAI Suite Integration has been explicitly shared with the page (Section 4, Step 3). |
SQAI Finds Top-Level Page, But Cannot Read Sub-Pages | C. Access Hierarchy: In some Notion setups, access must be explicitly granted down the hierarchy. | Verify Sharing: Ensure the top-level page that contains the required sub-pages/databases is correctly shared with the integration. |
Generic Connection Error | D. Incorrect Capabilities: The integration capabilities were not set correctly during creation. | Check Capabilities: Go back to the Integration settings (Section 4, Step 1) and confirm that Read content is checked and saved. |