Klairr connects to Amplitude via the Dashboard REST API using your project’s API key + secret key.
Step 1: Find your keys
In Amplitude: Settings → Projects → [your project] → General. Copy the API Key and Secret Key.
The secret key is read-only by Stripe Dashboard’s design — it can read every event your project has captured but cannot create projects, modify users, or change settings. Klairr never requests organization-wide credentials.
Step 2: Add the connector
| Field | Example |
|---|---|
| API key | … |
| Secret key | … |
| Region | US (default) or EU |
EU customers must select EU; otherwise requests will hit the US region and return 401.
What Klairr queries
- Schema is fetched from
/api/2/events/list(event taxonomy) and/api/2/eventproperties/list(property taxonomy). Klairr exposes a single virtualeventstable with the union of properties as columns. - Question answering translates the question into a JSON segmentation chart specification, which the connector executes via
/api/2/events/segmentation. Results are time-bucketed by interval (1, 7, or 30 days). - The Dashboard REST API is rate-limited (varies by tier). Klairr retries on 429 with backoff.
Notes
- The export API (raw event JSON) is not used — segmentation aggregates fit the question-answering shape better.
- Default time range is the last 30 days when a question doesn’t specify one.
- Property names with special characters (
$revenue,[Amplitude] Country) work as-is; they’re not aliased.