> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inflection.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Amplitude
> Use Amplitude product activity to build audiences, trigger journeys, and personalize messaging in Inflection.
Amplitude is a product analytics platform that captures user and group behavior across web, mobile, and server applications. The Amplitude integration sends those events to Inflection, so you can use Amplitude product activity to build audiences, trigger journeys, and personalize messaging in Inflection.
This article covers Amplitude as a **source** (Read flow), i.e., events flowing from Amplitude into Inflection. Amplitude as a destination is not yet supported.
## What You'll Receive From Amplitude
Inflection ingests events and user properties that Amplitude pushes through the direct partner integration. **Event names and event properties** become product activities in Inflection, available in the Product Data Explorer. **User properties** sent on `identify` calls map to Inflection user attributes.
## Prerequisites
Before you start, make sure you have:
* Admin access to your Inflection workspace.
* Admin access to your Amplitude project and permission to configure destinations in the Amplitude Integration Portal.
## Set Up the Amplitude Connection
Follow these steps to connect Amplitude as a source. Inflection generates a unique endpoint URL and API key for your workspace; you paste both into Amplitude's Integration Portal so Amplitude can push events to Inflection.
### Step 1: Open the Amplitude Connection
In Inflection, open the **Connections** sidebar and click **Amplitude**.
### Step 2: Generate Your API Key
The **Connect Amplitude** modal opens.
1. Review the connection summary.
2. Click **Generate API Key**.
3. Two fields appear:
* **Inflection Endpoint URL:** the HTTPS endpoint Amplitude will push events to. Click **Copy**.
* **API Key:** the authentication key Amplitude will use. Click **Copy**. Treat this key as sensitive — anyone with the key can send events to your Inflection workspace.
4. Click **Done** to save the connection.
### Step 3 Configure the Destination in Amplitude
In Amplitude:
1. Login to Amplitude as admin.
2. Go to **Data** → **Destinations** from the left menu bar.
3. Click **Add Destination** → **Webhook** type (Events and Users)
4. Copy these data points -
1. Webhook URL: [https://amplitude.webhook.inflection.io/integrations/amplitude/events](https://amplitude.webhook.inflection.io/integrations/amplitude/events)
2. Add these in Headers as key-value:
1. AUTHORIZATION: \
2. X-Inflection-App-Id: **ask Inflection team for this**
3. Content-Type: application/json
5. Send events:
1. Define event custom payload - paste this:
```javascript theme={null}
<#setting number_format="0.####">
{
"type": "track",
"messageId": <#if input.uuid??>"${input.uuid}"<#elseif input.insert_id??>"${input.insert_id}"<#else>"amp-${(input.user_id!'unknown')}-${input.event_time}",
"userId": <#if input.user_id??>"${input.user_id}"<#else>null,
"eventTime": "${input.event_time}",
"email": <#if input.user_properties?? && input.user_properties.email??>"${input.user_properties.email}"<#else>null,
"eventName": "${input.event_type}",
"properties": {<#if input.event_properties??><#list input.event_properties?keys as key><#assign value = input.event_properties[key]>"${key}": <#if value?is_number || value?is_boolean>${value}<#else>"${value}"<#if key_has_next>,},
"userProperties": {<#if input.user_properties??><#list input.user_properties?keys as key><#assign value = input.user_properties[key]>"${key}": <#if value?is_number || value?is_boolean>${value}<#else>"${value}"<#if key_has_next>,},
"orgIds": <#if parameters.groupTypeKey?has_content && input.groups?? && input.groups[parameters.groupTypeKey]??><#if input.groups[parameters.groupTypeKey]?is_sequence>[<#list input.groups[parameters.groupTypeKey] as v>"${v}"<#sep>,]<#else>["${input.groups[parameters.groupTypeKey]}"]<#else>[],
"sessionId": <#if input.session_id??><#if input.session_id?is_number>${input.session_id?c}<#else>"${input.session_id}"<#else>null,
"deviceId": <#if input.device_id??>"${input.device_id}"<#else>null,
"platform": <#if input.platform??>"${input.platform}"<#else>null,
"osName": <#if input.os_name??>"${input.os_name}"<#else>null,
"country": <#if input.country??>"${input.country}"<#else>null,
"region": <#if input.region??>"${input.region}"<#else>null,
"city": <#if input.city??>"${input.city}"<#else>null,
"language": <#if input.language??>"${input.language}"<#else>null,
"appVersion": <#if input.version_name??>"${input.version_name}"<#else>null,
"revenue": <#if input.revenue??><#if input.revenue?is_number>${input.revenue?c}<#else>"${input.revenue}"<#else>null,
"revenueType": <#if input.revenue_type??>"${input.revenue_type}"<#else>null,
"productId": <#if input.product_id??>"${input.product_id}"<#else>null,
"insertId": <#if input.insert_id??>"${input.insert_id}"<#else>null,
"library": <#if input.library??>"${input.library}"<#else>null,
"osVersion": <#if input.os_version??>"${input.os_version}"<#else>null,
"deviceBrand": <#if input.device_brand??>"${input.device_brand}"<#else>null,
"deviceModel": <#if input.device_model??>"${input.device_model}"<#else>null,
"deviceType": <#if input.device_type??>"${input.device_type}"<#else>null,
"ipAddress": <#if input.ip_address??>"${input.ip_address}"<#else>null,
"dma": <#if input.dma??>"${input.dma}"<#else>null,
"amplitudeUserId": <#if input.amplitude_id??><#if input.amplitude_id?is_number>${input.amplitude_id?c}<#else>"${input.amplitude_id}"<#else>null
}
```
6. Enable the events you want to forward to Inflection.
7. Enable the users you want to forward to Inflection.
8. Activate the webhook status and click Save.
9. Verify the connection with test data
10. After this, Amplitude will begin pushing events to Inflection within a few minutes.
## Manage the Connection
Once connected, the **Amplitude** entry in the Connections sidebar opens the Amplitude Connection Details page. The page has two tabs.
### Connection Details Tab
The Connection Details tab shows:
* A connection status badge **Connected** or **Disconnected**.
* The **Inflection API Key** in masked form with a **Copy** button.
* A **Refresh API Key** button.
### Refresh Your API Key
Refresh the API key if you suspect it has been exposed or want to rotate credentials.
1. On the Connection Details tab, click **Refresh API Key**.
2. Read the confirmation dialog: refreshing the key immediately deactivates the existing key.
3. Click **Confirm** to generate a new key.
4. Copy the new key and update it in Amplitude's Integration Portal. Event flow resumes once Amplitude is using the new key.
## Monitor Sync Activity
Use the **Sync Activity** tab on the Amplitude Connection Details page to monitor incoming events and troubleshoot delivery issues.
The tab shows:
* A **time range selector** — 24 hours, 30 days, 60 days, or 90 days.
* A **line chart** plotting **Events Received** and **Errors** over the selected range.
* An **error list** below the chart with columns for **Timestamp**, **Event Name**, **Error Type**, and **Description**. Expand a row to see the full event payload.
## Find Amplitude Events in the Product Data Explorer
Open **Connections** > **Product Data Explorer** to see every event that has reached Inflection across all connected sources, including Amplitude.
* The **Source** column at the top of the table lets you narrow the list to **Amplitude**, **Segment**, or **All Sources**.
* The **Source** column on each row shows the originating source for that event.
* Use the toggle on each row to enable an event for use in audiences, journeys, and personalization.
Click an event name to open its detail page. The detail page shows:
* **Event Name** and **Source**.
* An editable **Description**.
* A **Status** toggle for enabling or disabling the event.
* A **Properties** table listing each property with its **Data Type**, **Description**, and **Sample Preview**.
## Use Amplitude Data in Campaigns and Journeys
Once events are enabled and properties are mapped, Amplitude data is available everywhere product data is used in Inflection — no additional configuration is needed:
* **Dynamic lists and audiences:** filter on Amplitude event names, event counts, and mapped user properties.
* **Journey batch triggers and exit criteria:** Trigger journeys on Amplitude events or use them as exit conditions.
* **Contact profile:** Amplitude events appear in the product activity timeline alongside events from other sources.
* **Personalization tokens:** mapped Amplitude user properties can be used as tokens in email and other channels.
## Common Use Cases
* **Onboarding journeys driven by product behavior.** Trigger a welcome series when a user fires the `account_created` event in Amplitude, then branch based on whether they fire `first_value_milestone` within seven days.
* **Re-engagement based on activity gaps.** Build a dynamic list of users who have not fired any Amplitude event in the last 30 days and enroll them in a winback campaign.
* **Feature adoption nudges.** Target users who have fired the `feature_x_viewed` event but not `feature_x_used` within 14 days.
* **Cross-source segmentation.** Combine Amplitude product activity with attributes from your other connected sources (for example, Salesforce account stage) in a single audience.
## Amplitude Connection FAQ
The current feature covers Amplitude as a source only - events flow from Amplitude into Inflection. Sending Inflection marketing activities to Amplitude is not supported yet.
The previous key is deactivated immediately and Amplitude stops being able to push events until you save the new key in the Amplitude Integration Portal. Plan key rotations during low-traffic windows to minimize the event gap.
Check the **Sync Activity** tab on the Amplitude Connection Details page. The error list shows the most recent ingestion errors with the event name, error type, and description. If you see no events at all in the chart, verify the endpoint URL and API key in Amplitude's Integration Portal match the values shown in Inflection.