# Connect Amplitude

Connect Amplitude to Justwon, see what Justwon reads and may do, and disconnect it.

## Before you start

- **In Justwon:** you must be an owner or an admin of the workspace. A Amplitude connection belongs to the whole workspace. See [Roles](https://justwon.ai/docs/get-started/roles).
- **Your credential:** In Amplitude, copy the API key and the secret key of the project you want Justwon to read.

## Connect

1. Sign in to https://app.justwon.ai and open **Integrations**.
2. Open the **Available** tab, find **Amplitude** and select it. Its card says **Connect**.
3. Fill in the form, then select **Connect**. It asks for these values:
   - **API Key**. Your Amplitude project API Key (Organization Settings → API Keys, or Project Settings → General).
   - **Secret Key**. The matching project Secret Key. Shown once by Amplitude — Managers/Admins only.
   - **Account property** (optional). The custom USER property in Amplitude that carries the account identifier (defaults to account_id). Group/account types are not queryable via the API.
   - **Data residency region**. Which Amplitude instance hosts this project. Amplitude Settings → Organization shows it; querying the other instance returns no data.

Justwon does not read Amplitude on a schedule. It queries it when a question needs the figures.

## What Justwon reads

Justwon reads product usage figures from Amplitude, by running queries when a question needs them.

## What Justwon may do

Nothing. Justwon only reads from Amplitude; it never changes anything there.

## Disconnect

1. Open **Integrations** and the **Connected** tab, and select the Amplitude connection.
2. Open the **Configuration** tab. Under **Disconnecting**, select the button for Amplitude, then select **Disconnect**.

Reading stops and the connection is removed. What stays and what goes is the same for every tool: see [Where your data is held](https://justwon.ai/docs/security/where-your-data-is-held). Remove the key or token you created in Amplitude too, so nothing is left that could be used.

## If the connection does not finish

- **Amplitude says the credential is wrong.** Create it again and paste it without spaces before or after. Check that it belongs to an account that can see the data Justwon reads.
- **The connection stops later and asks you to reconnect.** The credential was removed or has expired. Select the connection and reconnect it with a new one. The configuration and everything already read are kept. See [a connection that is stuck](https://justwon.ai/docs/troubleshooting/connection-stuck).