Skip to main content

Amplitude

Integrating Amplitude with Osano​

Connecting to Amplitude​

In order for Osano to discover data stored in your systems, we must connect to those data providers via an API. We require, at minimum, read-only access to establish a connection to these providers. Each provider you connect may require different information. Please see the linked vendor documentation for instructions on where and how to obtain this data.

Setup​

An admin must create an API Key and enter that information in Osano to establish a connection via apiKey.

Authenticated Roles​

admin

Authentication Actions​

Authentication Methods​

  • oauth
  • apiKey

Core Functionality​

  • Data Discovery
  • User Search
  • Data Deletion

Base URL​

https://amplitude.com/api/2/

https://profile-api.amplitude.com/v1/

  • email
  • name
  • phoneNumber
  • address
  • birthday
  • userId

Which ID to enter​

Amplitude has three IDs for a user: the User ID (the ID your company assigns the user and sends to Amplitude), the Device ID, and the Amplitude ID (a number Amplitude generates). Osano reads profile data by User ID.

  • For the Sample Amplitude User ID on the connection, and the Amplitude User ID on an action item, enter the user's User ID.
  • To find it, open User Profiles in Amplitude, search for the user, and copy the User ID from their profile.
  • An Amplitude ID also works. Osano looks up the user and uses their User ID.
  • Anonymous users with no User ID have no profile Osano can read. If the sample ID matches no user, or only an anonymous one, the connection shows an error saying so.

Endpoints​

Used for data discovery

  • GET https://amplitude.com/api/2/usersearch?user={{email}}
  • GET https://profile-api.amplitude.com/v1/userprofile?user_id={{userId}}&get_cohort_ids=true
  • GET https://profile-api.amplitude.com/v1/userprofile?user_id={{userId}}&get_amp_props=true
  • GET https://profile-api.amplitude.com/v1/userprofile?user_id={{userId}}&get_recs=true
  • GET https://profile-api.amplitude.com/v1/userprofile?user_id={{userId}}&get_computations=true

Used for user search

  • GET https://amplitude.com/api/2/usersearch?user={{email}}
  • GET https://profile-api.amplitude.com/v1/userprofile?user_id={{userId}}&get_recs=true
  • GET https://profile-api.amplitude.com/v1/userprofile?user_id={{userId}}&get_amp_props=true
  • GET https://profile-api.amplitude.com/v1/userprofile?user_id={{userId}}&get_cohort_ids=true
  • GET https://profile-api.amplitude.com/v1/userprofile?user_id={{userId}}&get_computations=true

Used for data deletion

  • POST https://amplitude.com/api/2/deletions/users

Entering the ID on an action item​

Access ("Summarize") and deletion action items for Amplitude need the user's ID. Osano doesn't use the requestor's email for Amplitude.

  • On the action item, click the EDIT button next to the search term.

Segment edit user ID

  • Enter the user's User ID or Amplitude ID (see Which ID to enter). Separate multiple IDs with commas.

  • If no ID is entered, the automated search or deletion fails and the action item has to be processed manually.

Data Deletion​

  • Enter the User ID to delete all of the user's data. A User ID can be linked to more than one Amplitude ID (for example, profiles from different devices), and Osano deletes every one of them. If you enter an Amplitude ID instead, only that one profile is deleted, not the other profiles under the same User ID.

  • Amplitude usually processes deletion requests within 30 days of receiving the request.

Last Modified: 2026-10-14