Docs
Sign In

API Keys

API keys authenticate your AI agents, scripts, and custom integrations with FeedNest.

Pro plan required

API key creation requires an active FeedNest Pro subscription. View pricing →

Creating an API key

  1. 1

    Open Settings

    Go to Settings in your FeedNest dashboard.

  2. 2

    Navigate to Developer API

    Click the Developer API tab.

  3. 3

    Create a new key

    Click Create API Key. Choose a descriptive name (e.g., “Claude Desktop”, “Cursor IDE”) and select the permissions your integration needs.

  4. 4

    Copy and store securely

    Your key is shown once. Copy it immediately and store it in a secure location (password manager, environment variable, etc.).

Scopes (permissions)

Each API key has one or more scopes that control what it can access:

ScopePermissions
readRead feeds, articles, folders, tags, highlights, notes, stats, output feeds
writeSubscribe/unsubscribe feeds, create folders, mark read/unread, save articles, create highlights, notes, tags
aiAI-powered features: article summarization, text-to-speech

Best practices

  • Use descriptive names: name keys after their purpose (e.g., “Cursor IDE - work”, “Claude Desktop - personal”).
  • Minimum permissions: only grant the scopes your integration actually needs. Read-only integrations don't need write or ai scopes.
  • Use environment variables: store keys in env vars (e.g., FEEDNEST_API_KEY) instead of hardcoding them in config files.
  • Rotate regularly: revoke and recreate keys periodically, especially if you suspect a key has been compromised.
  • One key per integration: use separate keys for each AI client so you can revoke access individually.

Key security

Never share your API key publicly or commit it to version control. If a key is compromised, revoke it immediately in Settings → Developer API.