> ## 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.
</Warning>

## 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

<Info>
  You do not need to enter the Amplitude project name, project ID, or data region. UserJourneys detects the region from the key pair.
</Info>

## 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

<Steps>
  <Step title="Sign in to Amplitude">
    Open your Amplitude workspace:

    * US workspace: <a href="https://app.amplitude.com/login" target="_blank" rel="noreferrer">app.amplitude.com/login</a>
    * EU workspace: <a href="https://app.eu.amplitude.com/login" target="_blank" rel="noreferrer">app.eu.amplitude.com/login</a>
  </Step>

  <Step title="Open Organization settings">
    Click the gear icon in the top-right, then select **Organization settings**.

    <Frame caption="Amplitude organization settings with Projects in the left sidebar">
      <img src="https://mintcdn.com/userjourneysai/UJ_ZSp4TvjbE3D-J/images/amplitude_org_settings.png?fit=max&auto=format&n=UJ_ZSp4TvjbE3D-J&q=85&s=c7f158ee9f79117cc2755de3d4fd71bf" alt="Amplitude Organization settings page showing Projects in the Workspace sidebar" width="1224" height="625" data-path="images/amplitude_org_settings.png" />
    </Frame>
  </Step>

  <Step title="Open Projects">
    Select **Projects** in the left sidebar.

    <Frame caption="Amplitude Projects page with project selection">
      <img src="https://mintcdn.com/userjourneysai/UJ_ZSp4TvjbE3D-J/images/amplitude_projects.png?fit=max&auto=format&n=UJ_ZSp4TvjbE3D-J&q=85&s=91693bd1b44ff3b5312d0ec630131c99" alt="Amplitude Projects page showing project rows to select" width="1224" height="625" data-path="images/amplitude_projects.png" />
    </Frame>
  </Step>

  <Step title="Choose the Amplitude project">
    Select the project that contains the event data you want UserJourneys to analyze.
  </Step>

  <Step title="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.

    <Frame caption="Amplitude project details with Secret Key control">
      <img src="https://mintcdn.com/userjourneysai/UJ_ZSp4TvjbE3D-J/images/amplitude_project_detail.png?fit=max&auto=format&n=UJ_ZSp4TvjbE3D-J&q=85&s=79682e329eef25033eac6460fcbc8ee1" alt="Amplitude Project Details card showing API Key Manage and Secret Key Show controls" width="1224" height="625" data-path="images/amplitude_project_detail.png" />
    </Frame>

    <Warning>
      Treat the secret key like a password. Anyone with the API key and secret key can export project event data.
    </Warning>
  </Step>

  <Step title="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.
  </Step>

  <Step title="Submit the UserJourneys connection form">
    Submit the form after both values are filled in.
  </Step>
</Steps>

<Check>
  After we receive the keys, we validate that the Export API can read settled hourly event exports before enabling ingestion.
</Check>

## 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

<AccordionGroup>
  <Accordion title="I cannot see the secret key">
    Use an Amplitude account that can view project keys, then reopen the project's General tab.
  </Accordion>

  <Accordion title="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>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>