Skip to main content

Amplitude

Amplitude is a digital analytics platform that helps teams understand user behavior, measure engagement, and drive product growth through event-based tracking and analytics.

This connector provides access to Amplitude's Analytics REST APIs using basic authentication (API Key + Secret Key). It covers 11 API groups including Dashboard analytics, event export, behavioral cohorts, taxonomy management, session replay, and more.

Authentication​

Amplitude uses API Key authentication with HTTP Basic Auth. You need both your project's API Key and Secret Key, entered as a single credential in the format API_KEY:SECRET_KEY.

  • Auth Method: Basic authentication (base64-encoded)
  • Credential Format: API_KEY:SECRET_KEY
  • Example: a1b2c3d4e5:f6g7h8i9j0

Setting up Authentication​

Step 1: Find Your API Credentials​

  1. Log in to Amplitude
  2. Click the Settings cog in the top-right corner
  3. Under Organization settings, click Projects
  4. Select the project you want to connect

Step 2: Copy Your Keys​

  1. Copy the API Key (visible to managers directly in the project table)
  2. Click Generate or copy the Secret Key (you may need manager permissions)

Step 3: Configure in Willow​

Enter your credentials in the format API_KEY:SECRET_KEY:

a1b2c3d4e5f6g7h8:i9j0k1l2m3n4o5p6

Both the API Key and Secret Key are required. The connector automatically encodes them as a Basic auth header.

Available Tools​

This connector provides 31 tools across 11 API groups:

Dashboard REST API​

  • Get Chart Results - Retrieve JSON data from any saved Amplitude chart by its ID
  • Get Active or New Users - Get user counts with daily/weekly/monthly intervals and segmentation
  • List Events - Get all visible event types with weekly totals and DAU percentages
  • Event Segmentation - Query event metrics with grouping, filtering, and custom formulas
  • Funnel Analysis - Analyze funnel drop-off and conversion rates across event sequences. Provide two or more events as a JSON array string, e.g. [{"event_type":"signup"},{"event_type":"purchase"}]
  • Retention Analysis - Get user retention for start and return actions (n-day, rolling, bracket)
  • User Activity - Get a user's event stream and profile summary by Amplitude ID
  • User Search - Search for users by Amplitude ID, Device ID, or User ID
  • Real-Time Active Users - Get live active user counts with 5-minute granularity
  • Revenue LTV - Get lifetime value metrics (ARPU, ARPPU, total revenue, paying users)

Export API​

  • Export Events - Export raw event data for a date range (YYYYMMDDTHH format)

Behavioral Cohorts API​

  • List Cohorts - Get all discoverable cohorts with metadata and sync info
  • Request Cohort Export - Start an async cohort export and get a request ID to poll
  • Upload Cohort - Create or replace a cohort by uploading User IDs or Amplitude IDs

User Privacy API​

  • Delete User Data - Submit GDPR/CCPA deletion requests for user data (irreversible)
  • Get Deletion Jobs - Check the status of user data deletion requests

Chart Annotations API​

  • Create Annotation - Annotate important dates or time ranges on charts
  • List Annotations - Retrieve all annotations with filtering by category, chart, or date
  • Delete Annotation - Remove a chart annotation

Taxonomy API (Enterprise)​

  • List Event Types - Get all event types in the tracking plan
  • Get Event Type - Get details for a specific event type
  • List Event Categories - Get all event categories
  • List Event Properties - Get event properties (shared or event-specific)
  • List User Properties - Get all user properties in the tracking plan

Releases API​

  • Create Release - Document product releases with version, title, and timestamps

Lookup Table API​

  • List Lookup Tables - List all lookup tables in the project
  • Get Lookup Table - Retrieve a specific lookup table by name

Event Streaming Metrics API​

  • Get Delivery Metrics Summary - Monitor delivery metrics for event streaming destinations

User Mapping (Aliasing) API​

  • Get User Mappings - Look up cross-project user ID mappings

Session Replay API​

  • List Session Replays - Get a paginated list of session replays with filtering
  • Get Session Replay Files - Get presigned URLs for replay event files (rrweb format)

Rate Limits​

Amplitude enforces the following rate limits:

  • General: Up to 5 concurrent requests across all REST API endpoints
  • User Activity / User Search: Up to 10 concurrent requests, 360 queries per hour
  • Event Streaming Metrics: 4 concurrent requests, 12 per minute per project
  • Taxonomy API: Cost-based limits (4 concurrent cost, 7200 cost per hour)

Exceeding limits returns a 429 status code.

Troubleshooting​

"401 Unauthorized"​

Cause: Invalid or missing API credentials.

Solution:

  • Verify you entered credentials in the correct format: API_KEY:SECRET_KEY
  • Ensure there are no extra spaces or line breaks
  • Confirm the API Key and Secret Key belong to the same project
  • Check that the Secret Key hasn't been regenerated

"429 Too Many Requests"​

Cause: Rate limit exceeded.

Solution:

  • Reduce the number of concurrent requests
  • Add delays between requests
  • For User Activity/User Search, stay under 360 queries per hour

Taxonomy API returns "404 Not Found"​

Cause: The Taxonomy API requires an Enterprise plan.

Solution:

  • Confirm your Amplitude plan includes Enterprise features
  • Contact Amplitude support to verify API access

Lookup Table API returns "405 Method Not Allowed"​

Cause: The Lookup Table API requires the legacy_lookup_table_api feature, which is only available on paid plans.

Solution:

  • Confirm your Amplitude plan includes Lookup Table API access
  • Contact Amplitude support to enable the feature for your account

Export Events returns "404 Not Found"​

Cause: Amplitude generates export files with a minimum 2-hour delay after ingestion. Hours with no events also return 404.

Solution:

  • Wait at least 2 hours after events are ingested before exporting
  • Ensure there are events in the requested time range
On this page