Authentication for Manifold API

Obtaining Your API Token

Generate a New Token

To access the Manifold API, you'll need to generate an API token:

  1. Log into the Manifold Portal
  2. Navigate to Settings (bottom-left corner)
  3. Select the API Tokens tab
  4. Enter a descriptive Token Name (e.g., "Development Access")
  5. Click Generate Token
  6. Immediately Copy and Securely Store Your Token

Warning: You cannot view this token again after generation. Store it securely and treat it like a password.

API Authentication Mechanism

Required Headers

Every API request must include two critical headers:

Header NameDescriptionRequired
x-api-keyYour unique API tokenYes
Connection-IdSpecifies the data sourceDepends on endpoint

Example Request

curl --request GET 'https://api.analytics.autos/connections' \
--header 'x-api-key: YOUR_API_KEY'

Security Best Practices

Key Management

  • Never Share Your API Key
    • Treat as sensitive credentials

Troubleshooting Authentication

Common Authentication Errors

Error CodeMeaningSolution
401 UnauthorizedInvalid or expired tokenGenerate a new API key
403 ForbiddenInsufficient permissionsVerify account access levels

Verification Checklist

  • ✅ Confirm API key is valid
  • ✅ Ensure correct header syntax
  • ✅ Check connection permissions
  • ✅ Validate endpoint requirements

Key Lifecycle

Token Limitations

  • Cannot Refresh: Each token is a one-time generation
  • Full Account Access: Provides complete API permissions
  • Immediate Revocation: Can be disabled in portal

Getting Help

Experiencing authentication issues?