Authentication

Overview

The Eventually API uses Bearer token authentication. All API requests must include an Authorization header with your API key.

Getting Your API Key

1. Go to Settings > API & Webhooks
2. Click Generate API Key
3. Copy and store the key securely (it's shown once)

Making Requests

curl -X GET https://app.eventually.one/api/events \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json"

Rate Limits

Rate limit headers are included in every response:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1679616000

Error Responses

All errors return a consistent JSON format:

{
  "error": "Unauthorized",
  "message": "Invalid or expired API key"
}