Setting Up the Integration

Step 1: Create an Internal Integration

1. Go to notion.so/my-integrations
2. Click New integration
3. Name it (e.g., “NodeKAT”) and select the workspace that contains your content
4. Choose Internal integration as the type
5. Select the Workspace you want the integration to access
6. Click Submit

Step 2: Configure Capabilities

After creating the integration, you’ll land on its configuration page:

1. Under Capabilities, enable content reading:
   • Read content — allows NodeKAT to read page and database content
   • Read user information (optional) — allows user info lookups

These are read-only capabilities. The integration cannot create, edit, or delete content.

Step 3: Share Content with the Integration

For security, Notion integrations only see content that is explicitly shared with them:

1. Open the page or database you want to extract
2. Click the ••• menu in the top-right corner
3. Select Connections (or Add connections)
4. Find your integration (e.g., “NodeKAT”) and grant access

Scope note: Only content shared with the integration can be extracted. Unshared pages and databases are invisible to NodeKAT.

Step 4: Copy the API Key

1. On the integration configuration page, go to Secrets (or Internal Integration Secret)
2. Copy the Internal Integration Secret — this is your NOTION_API_KEY

The key looks like secret_... and grants read access to everything shared with the integration. Treat it as sensitive.

Step 5: Optional — Limit Extraction Scope

By default, NodeKAT searches the entire workspace. To limit extraction to specific content, provide the relevant IDs to your NodeKAT administrator:

Scope	Description
Database IDs	Extract rows from specific databases
Parent page IDs	Extract a page and all of its nested child pages

If neither is provided, NodeKAT searches the workspace for all shared content.

Next Steps

Provide the following credentials to your NodeKAT administrator:

• Internal Integration Secret (NOTION_API_KEY) — required
• Database IDs or parent page IDs — optional, to limit extraction scope

Your administrator will configure NodeKAT to use these credentials.

Authentication Architecture

NodeKAT authenticates to the Notion API using the integration token:

Required	Yes
Used For	Page extraction, database extraction, workspace search
Access Scope	Only content explicitly shared with the integration
Permissions	Read-only — cannot create, edit, or delete content
Inbound Access	None — NodeKAT only makes outbound API calls to Notion