Amplitude
Learn how to set up Amplitude as a destination for audience exports using a user property on the Amplitude Identify API.
Use Amplitude as a GrowthLoop destination to export Audiences as membership on an Amplitude user property. GrowthLoop appends and removes audience names on an array-type user property (default gl_audiences) using Amplitude's Identify API, matched to Amplitude users by user_id.
Prerequisites
Before you connect Amplitude to GrowthLoop, make sure you have:
- An Amplitude project with an API key and secret key (Settings > Projects in Amplitude).
- Confirmation that the GrowthLoop match field you plan to use (typically a CRM ID or similar) corresponds to the
user_idyour Amplitude project uses to identify users. GrowthLoop does not resolve email addresses or device IDs to Amplitude users in this version — onlyuser_idis supported.
NoteAmplitude creates the
gl_audiencesuser property automatically on first write — there is no need to pre-create it in Amplitude.
Set up destination
- In GrowthLoop, navigate to Destinations in the left sidebar.
- Click New Destination in the upper right corner.
- In the Select Destination window, search for Amplitude.
- Click Add Amplitude.
- Enter the following destination details:
- Destination Name: Enter a clear name your team will recognize in GrowthLoop.
- Sync Frequency: Choose how often GrowthLoop should export audiences by default. You can adjust the schedule when you configure an export.
- API Key: Enter your Amplitude project's API key.
- Secret Key: Enter your Amplitude project's secret key. GrowthLoop uses this only for a read-only credential check, never to write data.
- Region: Enter
usoreudepending on your Amplitude project's data residency. Defaults tous. - Audience Property: Optional. Defaults to
gl_audiences. The Amplitude user property GrowthLoop uses to track audience membership.
- Click Create. GrowthLoop validates the connection with a read-only call to the Amplitude Export API.
Export to destination
After you create the destination, you can export an Audience to Amplitude.
- Navigate to Audiences in the left sidebar.
- Open an existing Audience or create a new Audience.
- Click Export Audience.
- In the Create Export flow, select your Amplitude destination.
- Configure the export schedule and settings.
- In Match Fields, map your source identifier to User ID — this must match the
user_idAmplitude uses to identify the same person. - Click Export.
GrowthLoop sends an Identify API call per contact. Contacts added to the Audience have the audience name appended to the gl_audiences user property. Contacts removed from the Audience have the audience name removed from that property — other audience memberships on the same user are left untouched.
Configuration options
| Option | Description |
|---|---|
| API Key | Amplitude project API key. |
| Secret Key | Amplitude project secret key. |
| Region | Amplitude data residency: us or eu. Defaults to us. |
| Audience Property | Array-type Amplitude user property used to store audience membership. Created automatically. Defaults to gl_audiences. |
| Match fields | User ID only. Must match the user_id your Amplitude project uses to identify the same person. |
Find exported audience membership in Amplitude
After a successful export, open User Look-Up in the Amplitude dashboard and search for the user_id you exported. Confirm the audience name appears in the gl_audiences user property.
To confirm the export ran successfully in GrowthLoop, open the Audience Exports tab and review the export activity tracker.
Congrats on successfully connecting Amplitude as a destination!
NoteExperiencing any issues connecting to Amplitude? Reach out to us at [email protected] and we'll help resolve the matter.
Updated 1 day ago