Advanced Analytica Advanced Analytica: IBOM
← All connectors
Amplitude logo

Source connector

Amplitude

Set up Amplitude as a source and move its data into your chosen destination.

Version 0.7.40 certified generally available

Amplitude

Set up the Amplitude source connector to sync data from several Amplitude Analytics APIs. These include the Dashboard REST API, Export API, Chart Annotations API and Behavioral Cohorts API.

Prerequisites

You need an Amplitude API key and secret key to set up the source connector. To find these credentials:

  1. In the Amplitude Analytics web app, select Organization Settings in the upper navigation.
  2. Select Projects, then select your target project.
  3. Copy the API Key and Secret Key.

For more information, see Manage your API keys and secret keys in the Amplitude documentation.

Set up the source connector

  1. Log in to your Airbyte Cloud or Airbyte Open Source account.
  2. Select Sources, then select + New source.
  3. On the Set up the source page, select Amplitude from the Source type dropdown.
  4. Enter a name for your source.
  5. For API Key and Secret Key, enter your Amplitude API key and secret key.
  6. For Replication Start Date, enter the date in YYYY-MM-DDTHH:mm:ssZ format. Data added on or after this date is replicated. If you leave this field blank, Airbyte replicates all data.
  7. You can also configure these fields:
    • Data Region: Select EU Residency Server if your Amplitude project is hosted in the EU data center. The default is Standard Server.
    • Request Time Range: Set the interval, in hours, for each Events stream request. Requests that Amplitude rejects as too large or that time out are split automatically. The default is 24 hours. See Amplitude’s Export API considerations for details.
    • Active Users Group by Country: Enable this field to group Active Users stream results by country. Disable it if you encounter errors fetching the Active Users stream. It’s enabled by default.
  8. Select Set up source.

Supported streams

The Amplitude source connector supports these streams:

If you’d like Airbyte to support more endpoints, create an issue.

Supported sync modes

The Amplitude source connector supports these sync modes:

  • Full Refresh
  • Incremental

Performance considerations

The connector automatically handles Amplitude’s API rate limits. The Dashboard REST API applies cost-based rate limits. Its budget is 108,000 cost per hour and 1,000 cost per five-minute burst window. It also allows no more than five concurrent requests. The connector tracks each request’s cost and throttles automatically to stay within these limits.

The Export API, used by the Events stream, limits each export to 4 GB. It returns an error when a request exceeds this limit. Large exports can also time out. In either case, the connector halves the time window and retries each half automatically. With a Request Time Range of up to 1024 hours, splitting can reach a one-hour window. Above 1024 hours, splitting stops at windows of 8–9 hours. Successful splits never duplicate records. If a window is still rejected, the sync fails with a transient error. Each retry then reads the previously read parts again. The Append + Deduped sync mode removes these duplicates by uuid. An hour containing over 4 GB of data can only be exported with Amplitude’s Amazon S3 export. Splitting restarts for every window. If most syncs require splitting, lower the Request Time Range to avoid extra failed requests.

If you encounter rate limit issues that aren’t retried automatically, create an issue.

IP allow list

If you use Airbyte Cloud and your organisation restricts access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Changelog

Expand to review
VersionDatePull RequestSubject
0.7.402026-10-0685384Update dependencies
0.7.392026-10-0587560Automatically split Events export windows that exceed Amplitude’s 4 GB or timeout limits instead of failing the sync; parse zero-microsecond server_upload_time cursor values; show Amplitude’s error for Dashboard API 400s and retry their 504s; upgrade to CDK 7.32.0
0.7.382026-08-1884470Update dependencies
0.7.372026-08-1183823Update dependencies
0.7.362026-07-2882323Update dependencies
0.7.352026-07-1481744Update dependencies
0.7.342026-07-0780954Update dependencies
0.7.332026-07-0281393Bump h11 0.14.0 to 0.16.0 to resolve GHSA-vqfr-h8mv-ghfj
0.7.322026-06-2378601Update dependencies
0.7.312026-04-2872688Update dependencies
0.7.302026-03-3175406Upgrade CDK to v7.14.0 and use weight-based rate limiting for Dashboard REST API streams
0.7.292026-03-0370841Add HTTPAPIBudget and concurrency_level
0.7.282026-01-2071912Update dependencies
0.7.272026-01-1471434Update dependencies
0.7.262025-12-1870795Update dependencies
0.7.252025-11-2569522Update dependencies
0.7.242025-10-2968881Update dependencies
0.7.232025-10-2168361Update dependencies
0.7.222025-10-1467986Update dependencies
0.7.212025-10-0767159Update dependencies
0.7.202025-09-3062537Update dependencies
0.7.192025-09-1065994Update to CDK v7
0.7.182025-06-2862135Update dependencies
0.7.172025-06-2161897Update dependencies
0.7.162025-06-1560600Update dependencies
0.7.152025-05-2360887Fix cohorts extractor field_path
0.7.142025-05-1059808Update dependencies
0.7.132025-05-0359369Update dependencies
0.7.122025-04-2658709Update dependencies
0.7.112025-04-1958264Update dependencies
0.7.102025-04-1257605Update dependencies
0.7.92025-04-0557173Update dependencies
0.7.82025-03-2956591Update dependencies
0.7.72025-03-2256132Update dependencies
0.7.62025-03-0855359Update dependencies
0.7.52025-03-0154883Update dependencies
0.7.42025-02-2254247Update dependencies
0.7.32025-02-1552939Update dependencies
0.7.22025-02-1353655Fix CDK breaking change
0.7.12025-01-2552213Update dependencies
0.7.02025-01-2452144Promoting release candidate 0.7.0-rc.1 to a main version.
0.7.0-rc.12025-01-1751601Migrates to manifest-only
0.6.192025-01-1851723Update dependencies
0.6.182025-01-1151288Update dependencies
0.6.172025-01-0450906Update dependencies
0.6.162024-12-2850486Update dependencies
0.6.152024-12-2150150Update dependencies
0.6.142024-12-1449017Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64
0.6.132024-10-2947097Update dependencies
0.6.122024-10-1246771Update dependencies
0.6.112024-10-1146736Added possibility to toggle groupping by Country for Active Users stream
0.6.102024-10-0546489Update dependencies
0.6.92024-09-2846121Update dependencies
0.6.82024-09-2145732Update dependencies
0.6.72024-09-1445501Update dependencies
0.6.62024-09-0745318Update dependencies
0.6.52024-08-3145047Update dependencies
0.6.42024-08-2444709Update dependencies
0.6.32024-08-1744250Update dependencies
0.6.22024-08-1243876Update dependencies
0.6.12024-08-1043473Update dependencies
0.6.02024-08-0843400Add Events List Stream
0.5.12024-08-0343267Update dependencies
0.5.02024-08-0142565Migrate to CDK v4.0.2
0.4.22024-07-2742618Update dependencies
0.4.12024-07-2042302Update dependencies
0.4.02024-07-1742074Migrate to CDK v1.8.0
0.3.182024-07-1341767Update dependencies
0.3.172024-07-1041537Update dependencies
0.3.162024-07-0941097Update dependencies
0.3.152024-07-0640982Update dependencies
0.3.142024-06-2540407Update dependencies
0.3.132024-06-2240108Update dependencies
0.3.122024-06-0639103Use CheckpointMixin for state management
0.3.112024-06-0438988[autopull] Upgrade base image to v1.2.1
0.3.102024-04-1936631Updating to 0.80.0 CDK
0.3.92024-04-1236631schema descriptions
0.3.82024-03-1235987Unpin CDK version
0.3.72024-02-1235162Manage dependencies with Poetry.
0.3.62023-10-2331702Base image migration: remove Dockerfile and use the python-connector-base image
0.3.52023-09-2830846Add support of multiple cursor date formats
0.3.42023-09-2830831Add user friendly error description on 403 error
0.3.32023-09-2130652Update spec: declare start_date type as date-time
0.3.22023-09-1830525Fix KeyError while getting data_region from config
0.3.12023-09-1530471Fix Event stream: Use start_time instead of cursor in the case of more recent
0.3.02023-09-1330378Switch to latest CDK version
0.2.42023-05-0525842added missing attrs in events schema, enabled default availability strategy
0.2.32023-04-2025317Refactor Events Stream, use pre-YAML version based on Python CDK
0.2.22023-04-1925315Refactor to only fetch date_time_fields once per request
0.2.12023-02-0325281Reduce request_time_range to 4 hours
0.2.02023-02-0322362Migrate to YAML
0.1.242023-03-2821022Enable event stream time interval selection
0.1.232023-03-0223087Specified date formatting in specification
0.1.222023-02-1723192Skip the stream if start_date is specified in the future.
0.1.212023-02-0121888Set AvailabilityStrategy for streams explicitly to None
0.1.202023-01-2721957Handle null values and empty strings in date-time fields
0.1.192022-12-0919727Remove data_region as required
0.1.182022-12-0819727Add parameter to select region
0.1.172022-10-3118684Add empty series validation for AverageSessionLength stream
0.1.162022-10-1117854Add empty series validation for ActtiveUsers steam
0.1.152022-10-0317320Add validation start_date filed if it’s in the future
0.1.142022-09-2817326Migrate to per-stream states.
0.1.132022-08-3116185Re-release on new airbyte_cdk==0.1.81
0.1.122022-08-1115506Changed slice day window to 1, instead of 3 for Events stream
0.1.112022-07-2114924Remove additionalProperties field from spec
0.1.102022-06-1613846Try-catch the BadZipFile error
0.1.92022-06-1013638Fixed an infinite loop when fetching Amplitude data
0.1.82022-06-0113373Fixed the issue when JSON Validator produces errors on date-time check
0.1.72022-05-2113074Removed time offset for Events stream, which caused a lot of duplicated records
0.1.62022-04-3012500Improve input configuration copy
0.1.52022-04-2812430Added HTTP error descriptions and fixed Events stream fail caused by 404 HTTP Error
0.1.42021-12-238434Update fields in source-connectors specifications
0.1.32021-10-126375Log Transient 404 Error in Events stream
0.1.22021-09-216353Correct output schemas on cohorts, events, active_users, and average_session_lengths streams
0.1.12021-06-093973Add AIRBYTE_ENTRYPOINT for kubernetes support
0.1.02021-06-083664New Source: Amplitude
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.