Amplitude

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

​

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
   2. Add these in Headers as key-value:
      1. AUTHORIZATION: <API key from inflection>
      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:
      <#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}"</#if>,
      "userId": <#if input.user_id??>"${input.user_id}"<#else>null</#if>,
      "eventTime": "${input.event_time}",
      "email": <#if input.user_properties?? && input.user_properties.email??>"${input.user_properties.email}"<#else>null</#if>,
      "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><#if key_has_next>,</#if></#list></#if>},
      "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><#if key_has_next>,</#if></#list></#if>},
      "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>,</#sep></#list>]<#else>["${input.groups[parameters.groupTypeKey]}"]</#if><#else>[]</#if>,
      "sessionId": <#if input.session_id??><#if input.session_id?is_number>${input.session_id?c}<#else>"${input.session_id}"</#if><#else>null</#if>,
      "deviceId": <#if input.device_id??>"${input.device_id}"<#else>null</#if>,
      "platform": <#if input.platform??>"${input.platform}"<#else>null</#if>,
      "osName": <#if input.os_name??>"${input.os_name}"<#else>null</#if>,
      "country": <#if input.country??>"${input.country}"<#else>null</#if>,
      "region": <#if input.region??>"${input.region}"<#else>null</#if>,
      "city": <#if input.city??>"${input.city}"<#else>null</#if>,
      "language": <#if input.language??>"${input.language}"<#else>null</#if>,
      "appVersion": <#if input.version_name??>"${input.version_name}"<#else>null</#if>,
      "revenue": <#if input.revenue??><#if input.revenue?is_number>${input.revenue?c}<#else>"${input.revenue}"</#if><#else>null</#if>,
      "revenueType": <#if input.revenue_type??>"${input.revenue_type}"<#else>null</#if>,
      "productId": <#if input.product_id??>"${input.product_id}"<#else>null</#if>,
      "insertId": <#if input.insert_id??>"${input.insert_id}"<#else>null</#if>,
      "library": <#if input.library??>"${input.library}"<#else>null</#if>,
      "osVersion": <#if input.os_version??>"${input.os_version}"<#else>null</#if>,
      "deviceBrand": <#if input.device_brand??>"${input.device_brand}"<#else>null</#if>,
      "deviceModel": <#if input.device_model??>"${input.device_model}"<#else>null</#if>,
      "deviceType": <#if input.device_type??>"${input.device_type}"<#else>null</#if>,
      "ipAddress": <#if input.ip_address??>"${input.ip_address}"<#else>null</#if>,
      "dma": <#if input.dma??>"${input.dma}"<#else>null</#if>,
      "amplitudeUserId": <#if input.amplitude_id??><#if input.amplitude_id?is_number>${input.amplitude_id?c}<#else>"${input.amplitude_id}"</#if><#else>null</#if>
      }
      
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