dashboard/API Keys

API Keys

API keys authenticate your applications with the Intufind cloud service. Use them for custom integrations, the JavaScript SDK, or direct API calls.

Prerequisites

  • An active Intufind subscription
  • Access to the web dashboard

Accessing API Keys

Navigate to API Keys from the dashboard or go directly to intufind.com/dashboard/api-keys.

API Keys Page Screenshot: dashboard-api-keys.png

Your First API Key

When you sign up for your free trial, an API key is automatically created and displayed after signup. No credit card required. Copy it immediately — you won't be able to see the full key again.

Creating Additional Keys

Need more keys for different environments or sites?

  1. Click Create Key
  2. Enter a descriptive Key Name (e.g., "Production", "WordPress", "Staging")
  3. Click Create Key
  4. Copy your new key immediately

Security Warning: API keys are only shown once. If you lose a key, you'll need to create a new one.

API Key List

Your existing keys are displayed with:

FieldDescription
NameThe label you provided
PrefixFirst few characters (for identification)
CreatedWhen the key was created
Last UsedWhen the key was last used
StatusActive, Revoked, or Expired

Revoking a Key

To revoke a key:

  1. Click the ⋮ menu on the key row
  2. Select Revoke Key
  3. Confirm the action

Warning: Revoking a key is permanent. Any integrations using that key will immediately stop working.

Security Best Practices

Keep Keys Secret

  • Never commit API keys to version control
  • Don't share keys in public channels
  • Use environment variables in your applications

Use Environment Variables

# .env file (never commit this)
INTUFIND_API_KEY=if_sk_abc123...

// In your code
const apiKey = process.env.INTUFIND_API_KEY;

Use Separate Keys Per Environment

Create distinct keys for:

  • Development/local testing
  • Staging/QA
  • Production

This allows you to revoke a compromised key without affecting other environments.

Rotate Keys Periodically

For enhanced security:

  1. Create a new key
  2. Update your application to use the new key
  3. Verify everything works
  4. Revoke the old key

Using Your API Key

JavaScript SDK

import { IntufindClient } from '@intufind/ai-sdk';

const client = new IntufindClient({
  apiKey: process.env.INTUFIND_API_KEY,
});

// Search products
const results = await client.search.query({
  query: 'warm jacket',
});

REST API

curl -X POST https://api.intufind.com/v1/search \
  -H "Authorization: Bearer if_sk_abc123..." \
  -H "Content-Type: application/json" \
  -d '{"query": "warm jacket"}'

WordPress Plugin

Enter your API key in the WordPress admin under Intufind → API Key. See the WordPress installation guide for details.

Shopify App

The Shopify app handles authentication automatically through Shopify's billing system. No manual API key required.

Troubleshooting

"Subscription Required" Error

You need an active subscription to create API keys. Visit Billing to subscribe.

"Invalid API Key" Error

  • Verify the key is copied correctly (no extra spaces)
  • Check if the key has been revoked
  • Ensure you're using the right environment (live vs. test)

Key Not Working After Creation

  • Wait a few seconds for propagation
  • Verify the key format starts with if_sk_
  • Check your subscription is still active

Next Steps