Authentication

The ClarityCall API supports two authentication methods: API keys for server-to-server communication, and OAuth tokens for user-authenticated requests.

API Keys

API keys are the recommended authentication method for backend integrations. They provide full access to your account's data.

Creating an API Key

1. Go to Settings → API Keys
2. Click "Create API Key"
3. Give your key a descriptive name
4. Copy and securely store the key

Using API Keys

Include your API key in the Authorization header:

curl -X GET "https://api.claritycall.app/api/v2/recordings" \
  -H "Authorization: Bearer cc_live_your_api_key_here"

API Key Security

Session Tokens (Better Auth)

For user-authenticated requests from a frontend application, use Better Auth session tokens. These tokens are scoped to the authenticated user.

// Get the session token from Better Auth
import { authClient } from '$lib/auth/client';

const session = authClient.useSession();
const accessToken = session.get()?.data?.session?.token;

// Use it in API requests
const response = await fetch('https://api.claritycall.app/api/v2/recordings', {
  headers: {
    'Authorization': `Bearer ${accessToken}`,
    'Content-Type': 'application/json'
  }
});

Error Responses

Authentication errors return appropriate HTTP status codes: