Skip to main content

​
1. Base URL

The Novacal API follows standard REST conventions and is available only over HTTPS to protect request data and credentials in transit. Plain HTTP is not supported. Use the following base URL for all API requests: 
https://api.novacal.io

​
2. Create an API key

The Novacal API uses API keys to authenticate requests. If a request is sent without a valid API key, the API will return an authentication error. Create an API key from the API Keys settings page, then include it as a bearer token in your request headers: 
Authorization: Bearer YOUR_API_KEY

​
3. Test authentication

Make a simple authenticated request to confirm your API key is working: 
curl --request GET \
  --url https://api.novacal.io/v1/users/me \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Accept: application/json"
If the request succeeds, your API key is valid and you are ready to continue.

​
Response format

Successful responses use this shape: 
{
  "success": true,
  "data": {}
}

​
Rate limits

The default limit is 60 requests per minute per API key. If you exceed that, the API returns 429 Too Many Requests.

​
Next steps