clari-install-auth

# Clari Install & Auth ## Overview Set up Clari API access for exporting forecast data, pipeline snapshots, and revenue intelligence to your data warehouse. Clari uses API key authentication via the `apikey` header, with the primary API at `api.clari.com/v4/`. ## Prerequisites - Clari enterprise account with API access enabled - Admin or RevOps role for API key generation - Target data warehouse (Snowflake, BigQuery, or Redshift) for exports ## Instructions ### Step 1: Generate API Token 1. Log in to Clari at https://app.clari.com 2. Navigate to **User Settings** > **API Token** 3. Click **Generate New API Token** 4. Copy and store the token securely ```bash # Store securely -- never commit export CLARI_API_KEY="your-api-token-here" # Verify the key works curl -s -H "apikey: ${CLARI_API_KEY}" \ https://api.clari.com/v4/export/forecast/list \ | jq '.forecasts | length' ``` ### Step 2: Configure Environment ```bash # .env -- NEVER commit this file CLARI_API_KEY=your-api-token CLARI_BASE_URL=https://api.clari.com/v4 CLARI_ORG_ID=your-org-id # .gitignore .env .env.local ``` ### Step 3: Test API Connectivity ```python import requests import os api_key = os.environ["CLARI_API_KEY"] headers = {"apikey": api_key, "Content-Type": "application/json"} # List available forecasts response = requests.get( "https://api.clari.com/v4/export/forecast/list", headers=headers, ) response.raise_for_status() forecasts = response.json()["forecasts"] for fc in forecasts: ...