> ## Documentation Index
> Fetch the complete documentation index at: https://docs.userjourneys.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Amplitude Setup

> Find your Amplitude project keys and connect them to userjourneys.ai

Connect the Amplitude project that contains the event history you want to analyze. You do not need to create a new Amplitude project unless you want to test with a separate sandbox first.

> [!WARNING]
>
> Do not send API keys or secret keys in email, Slack, Linear, or support chat. Use the secure UserJourneys connection link your contact gives you, your company's password manager, or another approved secret-sharing tool.

## Before you start

Open the secure UserJourneys connection link your contact gave you. Keep it open while you follow this guide.

The connection form asks for:

* Amplitude API key
* Amplitude secret key

> [!NOTE]
>
> You do not need to enter the Amplitude project name, project ID, or data region. UserJourneys detects the region from the key pair.

## What you need

* An Amplitude project API key
* An Amplitude project secret key
* Permission to send one validation event, if you want us to verify the full ingest path

## Find your Amplitude keys

**1. Sign in to Amplitude**

Open your Amplitude workspace:

* US workspace: [app.amplitude.com/login](https://app.amplitude.com/login)
* EU workspace: [app.eu.amplitude.com/login](https://app.eu.amplitude.com/login)

**2. Open Organization settings**

Click the gear icon in the top-right, then select **Organization settings**.

![Amplitude Organization settings page showing Projects in the Workspace sidebar](https://mintcdn.com/userjourneysai/UJ_ZSp4TvjbE3D-J/images/amplitude_org_settings.png?fit=max\&auto=format\&n=UJ_ZSp4TvjbE3D-J\&q=85\&s=c7f158ee9f79117cc2755de3d4fd71bf)

Amplitude organization settings with Projects in the left sidebar

**3. Open Projects**

Select **Projects** in the left sidebar.

![Amplitude Projects page showing project rows to select](https://mintcdn.com/userjourneysai/UJ_ZSp4TvjbE3D-J/images/amplitude_projects.png?fit=max\&auto=format\&n=UJ_ZSp4TvjbE3D-J\&q=85\&s=91693bd1b44ff3b5312d0ec630131c99)

Amplitude Projects page with project selection

**4. Choose the Amplitude project**

Select the project that contains the event data you want UserJourneys to analyze.

**5. Copy the secret key**

In the project's **General** tab, find **Project Details**.

Click **Show** next to **Secret Key**, then paste that value into the UserJourneys connection form.

![Amplitude Project Details card showing API Key Manage and Secret Key Show controls](https://mintcdn.com/userjourneysai/UJ_ZSp4TvjbE3D-J/images/amplitude_project_detail.png?fit=max\&auto=format\&n=UJ_ZSp4TvjbE3D-J\&q=85\&s=79682e329eef25033eac6460fcbc8ee1)

Amplitude project details with Secret Key control

> [!WARNING]
>
> Treat the secret key like a password. Anyone with the API key and secret key can export project event data.

**6. Copy the API key**

Click **Manage** next to **API Key**. On **API and Secret Keys**, copy the key value for the same project and paste it into the UserJourneys connection form.

**7. Submit the UserJourneys connection form**

Submit the form after both values are filled in.

> [!TIP]
>
> After we receive the keys, we validate that the Export API can read settled hourly event exports before enabling ingestion.

## Validation event

For a brand-new or empty Amplitude project, we may ask permission to send one synthetic validation event. Amplitude accepts the event immediately, but the Export API can take a few hours before the event appears in hourly exports.

For a project that already has historical events, we can usually validate the read path immediately using older settled export hours.

## Troubleshooting

> [accordion] I cannot see the secret key
>
> Use an Amplitude account that can view project keys, then reopen the project's General tab.

> [accordion] I do not know whether my project is US or EU
>
> You do not need to provide the region. UserJourneys tests both Export API regions and uses the one that authenticates.

> [accordion] Our project has very high event volume
>
> Tell us your approximate events per day, and whether any single hour can exceed 4 GB of compressed export data. If hourly Export API reads are too large, we will discuss an existing warehouse export path instead.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.