Skip to main content

​
Overview

Phinite’s Amplitude predefined tool lets workspace assistants call Amplitude APIs through DevStudio after you save a connection under Integrations → Predefined tools. Manage Amplitude event tracking, analytics queries, taxonomy, cohorts, and user lookups via the Amplitude REST APIs. Predefined tools require a saved connection before they appear in Graph Studio’s tool picker. See Predefined Tools in GraphStudio.

​
What this integration enables

  • Automate workflows using this predefined tool from agent graphs
  • Connect once under Integrations and reuse across assistants
  • Enable individual subtools per agent in Graph Studio

​
Required credentials

  • API Key api_key (required)
  • Secret Key secret_key (required)
  • Region region (optional)
  • Project App ID app_id (optional)

​
Setup steps

  1. Sign in at amplitude.com → Settings → API Keys → select project → copy API Key and generate Secret Key. Set region to US or EU.
  2. Log into your Phinite workspace at app.phinite.ai
  3. Navigate to Integrations → Predefined tools
  4. Select Amplitude
  5. Click + Add Configuration
  6. Enter the credential fields listed above
  7. Select assistants that should use this connection
  8. Click Save Configuration

​
Configure in Graph Studio

  1. Open an agent in Graph Studio
  2. Select the agent node → Tools tab → Add a new tool
  3. Choose AmplitudeTool (or search for Amplitude)
  4. Select your saved connection or add a new one
  5. Enable the subtools your workflow needs and save

​
Predefined tools

Phinite provides 31 subtools for Amplitude:
  • Send Event: Uploads a single event to Amplitude via the HTTP V2 API. Requires event_type and at least one of user_id or device_id.
  • Send Batch Events: Uploads multiple events to Amplitude in a single batch request. Each event must include event_type and at least user_id or device_id.
  • Identify User: Sets or updates user properties without sending a behavioral event. Requires user_id or device_id plus user_properties.
  • Group Identify: Sets or updates properties on a group (e.g. company, org) without sending a behavioral event.
  • Track Revenue: Tracks a revenue event for a user. Requires user_id or device_id and at least one revenue field.
  • Get Event Segmentation: Returns event segmentation data — event counts or metrics broken down over a time range. Requires event, start, and end.
  • Get Funnel Analysis: Returns funnel conversion data between a sequence of events over a time range.
  • Get Retention Analysis: Returns retention data showing how many users return after performing an initial event.
  • Get User Sessions: Returns average session length and session count data over a time range.
  • Get User Composition: Returns a breakdown of active users by a user property (e.g. country, platform, version).
  • Get User Event List: Returns the recent event stream for a specific user by their numeric Amplitude ID.
  • Get Annotations: Returns a list of all chart annotations defined in the project.
  • Export Chart: Exports a saved chart as a PNG, SVG, or PDF image. Returns the binary image as a base64-encoded string.
  • Get Event Types: Returns a list of all event types defined in the taxonomy for the project.
  • Create Event Type: Creates a new event type in the project taxonomy. Requires event_type (name).
  • Update Event Type: Updates an existing event type in the taxonomy. Requires event_type (current name).
  • Delete Event Type: Deletes an event type from the taxonomy. Irreversible.
  • Get Event Properties: Returns all properties defined for the specified event type.
  • Create Event Property: Creates a new property for the specified event type. Requires event_type and event_property (name).
  • Get User Properties: Returns all user properties defined in the project taxonomy.
  • Create User Property: Creates a new user property in the taxonomy. Requires user_property (name).
  • Get Group Properties: Returns all properties defined for the specified group type.
  • Get Cohorts: Returns a list of all cohorts in the project.
  • Get Cohort: Returns metadata for the specified cohort by cohort_id.
  • Create Cohort: Creates (uploads) a new cohort from an explicit list of user IDs. Requires name, ids, and an owner email.
  • Update Cohort: Adds and/or removes members of an existing cohort. Cannot rename a cohort.
  • Download Cohort: Downloads the full membership list of a cohort as a CSV (base64-encoded). Polls until ready, then returns the CSV data.
  • Search Users: Searches for a user by user_id or Amplitude ID. Returns matching user profiles.
  • Get User Activity: Returns the full event activity stream for the specified user by Amplitude ID.
  • Get User Properties By Id: Returns the current user property values for the specified user by Amplitude ID.
  • Update User Properties: Updates user properties for the specified user by user_id using the Identify API.

​
Documentation & resources

  • Official documentation: https://www.docs.developers.amplitude.com/
  • Phinite documentation: Amplitude

​
Notes

  • Store API keys and tokens securely; many providers show secrets only once
  • Use separate connections for Dev, UAT, and Prod environments where possible
  • Test with a minimal subtool call after saving credentials