Authentication

Learn how to authenticate your requests to the NeetoForm API using API keys.

Generating an API Key

To use the NeetoForm APIs, you must first generate an API key. Learn how to generate your API key here.

Making Authenticated API Requests

To authenticate your API requests, include a valid API key in the X-Api-Key header.

curl https://spinkart.neetoform.com/api/external/v1/forms \
  -H 'X-Api-Key: your-api-key' \
  -H "Content-Type: application/json"

Header Format

Include your API key in the X-Api-Key header of every request:

X-Api-Key: your_api_key_here

Generate separate API keys for different workspaces. An API key generated in one workspace will not work in another.

API keys provide access to sensitive data. Treat them like passwords and follow security best practices.

Error Responses

401 Unauthorized

If your API key is missing, invalid, or expired, you’ll receive a 401 error:

{
  "error": "Could not authenticate, invalid API Key"
}

Common Authentication Issues

Invalid API Key

Problem: API key is missing or invalid
Solution: Verify your API key is correct and hasn’t been revoked/expired

Incorrect workspace subdomain

Problem: Subdomain is left as the default value (spinkart) or incorrect
Solution: Verify your subdomain name is properly added in the request URL