Skip to content
CueCapture

API Key Setup

CueCapture connects to Notion through the official Notion API. This guide walks you through creating an integration and getting your API key.

What You’ll Need

Section titled “What You’ll Need”
  • A Notion account (free or paid)
  • Admin or member access to a Notion workspace
  • About 5 minutes

Creating Your Integration

Section titled “Creating Your Integration”

  1. Go to Notion Integrations

    Visit notion.so/my-integrations in your browser. Sign in with your Notion account if prompted.

  2. Create New Integration

    Click the ”+ New integration” button.

    Create new integration button

  3. Configure Your Integration

    Fill in the following:

    • Name: Enter a name like “CueCapture” or “Task Widget”
    • Logo: Optional - you can skip this
    • Associated workspace: Select your workspace

  4. Set Capabilities

    Make sure these capabilities are enabled:

    • ✅ Read content
    • ✅ Update content
    • ✅ Insert content
    • ❌ Read comments (not needed)
    • ❌ Insert comments (not needed)

    For “User information”, select “No user information” unless you want to see who assigned tasks.

  5. Submit

    Click “Submit” to create the integration.

  6. Copy Your API Key

    After creating the integration, you’ll see your “Internal Integration Secret”.

    • Click “Show” to reveal it
    • Click “Copy” to copy it to your clipboard

    The key looks like: ntn_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX or secret_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Entering the Key in CueCapture

Section titled “Entering the Key in CueCapture”

  1. Open CueCapture settings (gear icon ⚙️)

  2. Go to Notion Databases section

  3. Paste your API key in the “Notion API Key” field

  4. Click “Verify” to test the connection

If verification succeeds, you’re ready to connect your databases!

Troubleshooting

Section titled “Troubleshooting”

”Invalid API Key” Error

Section titled “”Invalid API Key” Error”
  • Make sure you copied the entire key, including the ntn_ or secret_ prefix
  • Check for extra spaces before or after the key
  • Verify the integration wasn’t deleted in Notion

”No Access” Error

Section titled “”No Access” Error”

This usually means:

  • The integration was created in a different workspace than your database
  • You haven’t shared your database with the integration yet (see next section)

Can’t Find My Integration

Section titled “Can’t Find My Integration”
  • Make sure you’re signed into the same Notion account
  • Visit notion.so/my-integrations directly
  • Check if you have multiple workspaces and switched to the wrong one

Sharing Databases with Your Integration

Section titled “Sharing Databases with Your Integration”

After creating the integration, you must share each database you want CueCapture to access:

  1. Open your tasks database in Notion

  2. Click the ”…” menu in the top-right corner

  3. Select “Connections” (or “Add connections” in older versions)

  4. Find your integration in the list and click it

  5. Click “Confirm”

Security Notes

Section titled “Security Notes”

What CueCapture Can Access

Section titled “What CueCapture Can Access”

With your API key, CueCapture can only access:

  • Databases you explicitly share with the integration
  • Pages within those databases
  • Properties you’ve configured

CueCapture cannot access:

  • Your entire Notion workspace
  • Databases you haven’t shared
  • Your Notion account credentials
  • Other users’ private pages

Where Your Key is Stored

Section titled “Where Your Key is Stored”
  • On Windows: Encrypted in the Windows Credential Manager
  • On macOS: Stored in the system Keychain
  • Never sent to CueCapture servers - only to Notion directly

Revoking Access

Section titled “Revoking Access”

If you ever want to revoke CueCapture’s access:

  1. Go to notion.so/my-integrations
  2. Click on your CueCapture integration
  3. Click “Delete this integration”

This immediately revokes all access. CueCapture will no longer be able to read or write to your Notion databases.

Next Steps

Section titled “Next Steps”

Now that you have your API key set up, it’s time to connect your databases: