Skip to main content
Developer Portal

Authentication

Secure your API requests with API keys.

API Key Authentication

Include your API key in the Authorization header of every request:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.wisepim.com/v2/products

Creating API Keys

  1. 1.Go to Settings > API Keys in your dashboard
  2. 2.Click Create new API key
  3. 3.Give it a descriptive name (e.g., “Production sync”)
  4. 4.Select the permission scopes you need
  5. 5.Copy the key immediately — it won't be shown again

Permission Scopes

products:readRead product data
products:writeCreate, update, and delete products
categories:readRead category data
categories:writeManage categories
enrichment:executeTrigger AI enrichment and translation
integrations:readView integration status
integrations:manageConfigure and trigger syncs
webhooks:manageCreate and manage webhooks

Security Best Practices

  • Never expose API keys in client-side code or public repositories
  • Use environment variables to store keys
  • Rotate keys periodically and revoke unused ones
  • Use the minimum required permission scopes
  • Monitor API key usage in the dashboard for anomalies