airbyte/docs/integrations/sources/amplitude.md

Amplitude

This page guides you through setting up the Amplitude source connector to sync data for the Amplitude API.

Prerequisite

To set up the Amplitude source connector, you'll need your Amplitude API Key and Secret Key.

Set up the Amplitude source connector

1. Log into your Airbyte Cloud or Airbyte Open Source account.
2. Click Sources and then click + 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 the Amplitude API key and secret key.
6. For Replication Start Date, enter the date in YYYY-MM-DDTHH:mm:ssZ format. The data added on and after this date will be replicated. If this field is blank, Airbyte will replicate all data.
7. Click Set up source.

Supported Streams

The Amplitude source connector supports the following streams:

• Active Users Counts (Incremental sync)
• Annotations
• Average Session Length (Incremental sync)
• Cohorts
• Events (Incremental sync)
• Events List

If there are more endpoints you'd like Airbyte to support, please create an issue.

Supported sync modes

The Amplitude source connector supports the following sync modes:

• Full Refresh
• Incremental

Connector-specific features

There are two data region servers supported by Airbyte:

• Standard Server
• EU Residency Server

The Standard Server will be the default option until you change it in the Optional fields.

Performance considerations

The Amplitude connector ideally should gracefully handle Amplitude API limitations under normal usage. Create an issue if you see any rate limit issues that are not automatically retried successfully.

Changelog

Expand to review

Version	Date	Pull Request	Subject
0.7.26	2025-12-09	70795	Update dependencies
0.7.25	2025-11-25	69522	Update dependencies
0.7.24	2025-10-29	68881	Update dependencies
0.7.23	2025-10-21	68361	Update dependencies
0.7.22	2025-10-14	67986	Update dependencies
0.7.21	2025-10-07	67159	Update dependencies
0.7.20	2025-09-30	62537	Update dependencies
0.7.19	2025-09-08	65994	Update to CDK v7
0.7.18	2025-06-28	62135	Update dependencies
0.7.17	2025-06-21	61897	Update dependencies
0.7.16	2025-06-15	60600	Update dependencies
0.7.15	2025-05-23	60887	Fix cohorts extractor field_path
0.7.14	2025-05-10	59808	Update dependencies
0.7.13	2025-05-03	59369	Update dependencies
0.7.12	2025-04-26	58709	Update dependencies
0.7.11	2025-04-19	58264	Update dependencies
0.7.10	2025-04-12	57605	Update dependencies
0.7.9	2025-04-05	57173	Update dependencies
0.7.8	2025-03-29	56591	Update dependencies
0.7.7	2025-03-22	56132	Update dependencies
0.7.6	2025-03-08	55359	Update dependencies
0.7.5	2025-03-01	54883	Update dependencies
0.7.4	2025-02-22	54247	Update dependencies
0.7.3	2025-02-15	52939	Update dependencies
0.7.2	2025-02-13	53655	Fix CDK breaking change
0.7.1	2025-01-25	52213	Update dependencies
0.7.0	2025-01-24	52144	Promoting release candidate 0.7.0-rc.1 to a main version.
0.7.0-rc.1	2025-01-17	51601	Migrates to manifest-only
0.6.19	2025-01-18	51723	Update dependencies
0.6.18	2025-01-11	51288	Update dependencies
0.6.17	2025-01-04	50906	Update dependencies
0.6.16	2024-12-28	50486	Update dependencies
0.6.15	2024-12-21	50150	Update dependencies
0.6.14	2024-12-14	49017	Starting 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.13	2024-10-29	47097	Update dependencies
0.6.12	2024-10-12	46771	Update dependencies
0.6.11	2024-10-11	46736	Added possibility to toggle groupping by Country for Active Users stream
0.6.10	2024-10-05	46489	Update dependencies
0.6.9	2024-09-28	46121	Update dependencies
0.6.8	2024-09-21	45732	Update dependencies
0.6.7	2024-09-14	45501	Update dependencies
0.6.6	2024-09-07	45318	Update dependencies
0.6.5	2024-08-31	45047	Update dependencies
0.6.4	2024-08-24	44709	Update dependencies
0.6.3	2024-08-17	44250	Update dependencies
0.6.2	2024-08-12	43876	Update dependencies
0.6.1	2024-08-10	43473	Update dependencies
0.6.0	2024-08-08	43400	Add Events List Stream
0.5.1	2024-08-03	43267	Update dependencies
0.5.0	2024-08-01	42565	Migrate to CDK v4.0.2
0.4.2	2024-07-27	42618	Update dependencies
0.4.1	2024-07-20	42302	Update dependencies
0.4.0	2024-07-17	42074	Migrate to CDK v1.8.0
0.3.18	2024-07-13	41767	Update dependencies
0.3.17	2024-07-10	41537	Update dependencies
0.3.16	2024-07-09	41097	Update dependencies
0.3.15	2024-07-06	40982	Update dependencies
0.3.14	2024-06-25	40407	Update dependencies
0.3.13	2024-06-22	40108	Update dependencies
0.3.12	2024-06-06	39103	Use CheckpointMixin for state management
0.3.11	2024-06-04	38988	[autopull] Upgrade base image to v1.2.1
0.3.10	2024-04-19	36631	Updating to 0.80.0 CDK
0.3.9	2024-04-12	36631	schema descriptions
0.3.8	2024-03-12	35987	Unpin CDK version
0.3.7	2024-02-12	35162	Manage dependencies with Poetry.
0.3.6	2023-10-23	31702	Base image migration: remove Dockerfile and use the python-connector-base image
0.3.5	2023-09-28	30846	Add support of multiple cursor date formats
0.3.4	2023-09-28	30831	Add user friendly error description on 403 error
0.3.3	2023-09-21	30652	Update spec: declare start_date type as date-time
0.3.2	2023-09-18	30525	Fix KeyError while getting data_region from config
0.3.1	2023-09-15	30471	Fix Event stream: Use start_time instead of cursor in the case of more recent
0.3.0	2023-09-13	30378	Switch to latest CDK version
0.2.4	2023-05-05	25842	added missing attrs in events schema, enabled default availability strategy
0.2.3	2023-04-20	25317	Refactor Events Stream, use pre-YAML version based on Python CDK
0.2.2	2023-04-19	25315	Refactor to only fetch date_time_fields once per request
0.2.1	2023-02-03	25281	Reduce request_time_range to 4 hours
0.2.0	2023-02-03	22362	Migrate to YAML
0.1.24	2023-03-28	21022	Enable event stream time interval selection
0.1.23	2023-03-02	23087	Specified date formatting in specification
0.1.22	2023-02-17	23192	Skip the stream if start_date is specified in the future.
0.1.21	2023-02-01	21888	Set AvailabilityStrategy for streams explicitly to None
0.1.20	2023-01-27	21957	Handle null values and empty strings in date-time fields
0.1.19	2022-12-09	19727	Remove data_region as required
0.1.18	2022-12-08	19727	Add parameter to select region
0.1.17	2022-10-31	18684	Add empty series validation for AverageSessionLength stream
0.1.16	2022-10-11	17854	Add empty series validation for ActtiveUsers steam
0.1.15	2022-10-03	17320	Add validation start_date filed if it's in the future
0.1.14	2022-09-28	17326	Migrate to per-stream states.
0.1.13	2022-08-31	16185	Re-release on new airbyte_cdk==0.1.81
0.1.12	2022-08-11	15506	Changed slice day window to 1, instead of 3 for Events stream
0.1.11	2022-07-21	14924	Remove additionalProperties field from spec
0.1.10	2022-06-16	13846	Try-catch the BadZipFile error
0.1.9	2022-06-10	13638	Fixed an infinite loop when fetching Amplitude data
0.1.8	2022-06-01	13373	Fixed the issue when JSON Validator produces errors on date-time check
0.1.7	2022-05-21	13074	Removed time offset for Events stream, which caused a lot of duplicated records
0.1.6	2022-04-30	12500	Improve input configuration copy
0.1.5	2022-04-28	12430	Added HTTP error descriptions and fixed Events stream fail caused by 404 HTTP Error
0.1.4	2021-12-23	8434	Update fields in source-connectors specifications
0.1.3	2021-10-12	6375	Log Transient 404 Error in Events stream
0.1.2	2021-09-21	6353	Correct output schemas on cohorts, events, active_users, and average_session_lengths streams
0.1.1	2021-06-09	3973	Add AIRBYTE_ENTRYPOINT for kubernetes support
0.1.0	2021-06-08	3664	New Source: Amplitude
0.1.0	2021-06-08	3664	New Source: Amplitude