Guides
Authentication
API key authentication for the Oviond Integration API
Authentication
All API requests require two headers for authentication and project identification.
Required Headers
| Header | Value | Description |
|---|---|---|
Authorization | Bearer oviond_xxx | Your Oviond API key |
X-Client-ID | CLIENT_ID | Your CLIENT ID |
Getting an API Key
- Log in to the Oviond app
- Go to Settings > API Keys
- Click Create API Key
- Copy the key — it will only be shown once
API keys are prefixed with oviond_ and should be kept secret. Do not expose them in client-side code.
Finding Your Client ID
The X-Client-ID is the CLIENT ID that identifies which project's integrations and credentials to use. You can find this in the Oviond app under your project settings.
Example Request
curl -X POST https://api.oviond.com/v1/integrations/{id}/query \
-H "Content-Type: application/json" \
-H "Authorization: Bearer oviond_xxx" \
-H "X-Client-ID: YOUR_CLIENT_ID" \
-d '{
"dataView": "default",
"metrics": ["metric_1", "metric_2"],
"dateRange": {
"current": { "startDate": "2025-01-01", "endDate": "2025-01-31" },
"previous": { "startDate": "2024-12-01", "endDate": "2024-12-31" }
},
"timezone": "UTC"
}'Testing Your API Key
Validate that your API key and client ID are working:
curl -X POST https://api.oviond.com/v1/integrations/{id}/test \
-H "Content-Type: application/json" \
-H "Authorization: Bearer oviond_xxx" \
-H "X-Client-ID: YOUR_CLIENT_ID" \
-d '{}'A successful response returns status 200. Failed auth returns status 401 with an error message.
Error Responses
| Status | Error | Cause |
|---|---|---|
401 | Missing or invalid Authorization header | No Authorization header or wrong format |
401 | Invalid API key | API key not found or revoked |
400 | Missing X-Client-ID header | No X-Client-ID header provided |