Troubleshooting
    4 min read

    API Authentication Issues

    Resolve API key and authentication errors

    API Authentication Issues

    Troubleshoot API authentication problems.

    Error: "Invalid API Key"

    Cause: The API key is incorrect or malformed

    Fix:

  1. Go to Settings → API Keys
  2. Copy the full API key (starts with "sos_")
  3. Ensure no extra spaces
  4. Use in the X-API-Key header

    5. Error: "API Key Expired"

    Cause: Key has passed its expiration date

    Fix:

  5. Go to Settings → API Keys
  6. Check the expiration date
  7. Rotate the key or create a new one
  8. Update your integration with new key

    9. Error: "Rate Limit Exceeded"

    Cause: Too many requests in time window

    Details:

  9. 60 requests per minute (default)
  10. 1,000 requests per day

    11. Fix:

  11. Implement exponential backoff
  12. Cache responses where possible
  13. Contact support for limit increase

    14. Error: "Unauthorized"

    Cause: Missing or incorrect authorization

    Fix:

  14. Ensure header is "X-API-Key" (not "Authorization")
  15. Check the key is active
  16. Verify account is in good standing

    17. Testing Your Key

    Use this curl command:

    curl -X GET "https://api.salesos.com/v1/leads" \
  -H "X-API-Key: YOUR_API_KEY"

    Security Best Practices

  17. Never expose keys in client-side code
  18. Rotate keys regularly
  19. Use environment variables
  20. Monitor usage for anomalies

    21. Was this article helpful?

    Related Articles

    API Documentation Overview

    Getting started with the SalesOS API

    Rate Limit Exceeded Solutions

    Handle API rate limiting gracefully

    API
    authentication
    errors
    keys