Intercom
Use GrowthLoop audiences for Intercom contact attributes you can filter on.
Connect this destination to export audience membership as a flywheel_segment_id custom attribute on Intercom contacts, for use in Intercom messages.
This destination writes to your Intercom account and is a good fit when you want to:
- Make GrowthLoop audiences available for Intercom messaging
- Match contacts on Intercom External ID and email
This maps to GrowthLoop Audiences and Journeys:
| Use it for | Audiences | Journeys |
|---|---|---|
| Marking audience membership on Intercom contacts | ✓ | ✓ |
Prerequisites
Make sure you have:
- An Intercom account you can authorize for GrowthLoop.
- A dataset column for Intercom External ID.
- A dataset column for the contact's email. GrowthLoop uses email to find or create the Intercom contact.
- The GrowthLoop Team this destination should belong to, if your organization uses more than one team.
Set up Intercom as a destination
- In GrowthLoop, click the Destinations tab on the left sidebar.
- Click New Destination in the upper right corner.
- Search for Intercom under Livechat and click Add Intercom.

- Log in to Intercom and authorize access for GrowthLoop.

- After you grant GrowthLoop access, enter the required information, then click Create.

| Field | Description |
|---|---|
| Team | The GrowthLoop team this destination belongs to. If your organization has more than one team, select the team your user belongs to. |
| Destination Name | Name this destination in GrowthLoop. Use a name so your team recognizes its purpose, like "Intercom Messaging". |
| Sync Frequency | Set the default export frequency to Daily or Hourly. You can override this setting for individual exports. |
| OAUTH Token | Automatically populated when Intercom redirects you back to GrowthLoop. If it is empty, generate the token in Intercom and try again. |
GrowthLoop validates the connection by calling Intercom as that authorized user. Intercom then appears in your list of connected destinations.
Export to Intercom
From within GrowthLoop, export from an audience or from a journey Destination Node. See Export an audience or Build a journey if you need more information on these steps.
After building or selecting an audience, click Export, then search for Intercom. In a journey, add a Destination Node under Livechat and select Intercom.

Map contact identifiers
On an audience or in a journey Destination Node, map Intercom External ID. This field is required in the export.
GrowthLoop also needs email on each row to find or create the Intercom contact. Map the warehouse column that holds the email address you use in Intercom.
This destination does not send additional personalization fields.
Configure the export
This is where you set the campaign type and schedule for audience exports. On a journey Destination Node, you set timing on the journey canvas.
| Setting | Audience export | Journey Destination Node |
|---|---|---|
| Export Name | Defaults to the audience name. GrowthLoop writes that name into flywheel_segment_id. | Required. Enter a name so you can find the export in GrowthLoop. GrowthLoop writes that name into flywheel_segment_id. |
| Campaign type | Choose a one-time or ongoing export. | The journey schedule controls when the journey runs and contacts are sent to Intercom. |
| Schedule | Set frequency, start date, end date, and days of the week for ongoing exports. | Users reach this node when the journey runs. Add a Delay Node or set Criteria Evaluation to control timing. |
Export behavior
This is what GrowthLoop writes when you export an audience.
| Behavior | What happens |
|---|---|
| What GrowthLoop writes | The flywheel_segment_id custom attribute on the Intercom contact. The value is a list of GrowthLoop audience names. Direction is GrowthLoop → Intercom. |
| When it runs | GrowthLoop sends the export as a batch on the next successful run. An export that starts Now runs within about 15 minutes. Journeys send exports on demand when users reach the Destination Node. |
| Match fields | Intercom External ID is required in the export. GrowthLoop finds or creates the contact by email. |
| Contact create | If Intercom has no matching contact, GrowthLoop creates one and sets flywheel_segment_id. |
| Archived contacts | If the email matches an archived contact, GrowthLoop unarchives it and then updates membership. |
| One-time exports | GrowthLoop adds the audience name to flywheel_segment_id for current members. |
| Ongoing adds and removals | Ongoing exports add the audience name when someone enters and remove it when they leave. |
| Deletes | GrowthLoop does not delete Intercom contacts. |
| Intercom segments | GrowthLoop does not write an Intercom segment. Build a segment in Intercom that filters on flywheel_segment_id. |
Confirm the export was successful
When the run finishes, confirm you can use the data in Intercom.
- Audience export: Open People and look up a contact from the export. Check the
flywheel_segment_idcustom attribute. It should include the GrowthLoop audience name. - Journey Destination Node: Open People and look up a contact who reached the node. Check that
flywheel_segment_idincludes the export name.
To message those contacts, create an Intercom segment that filters on flywheel_segment_id containing that audience name.
In GrowthLoop, review Added, Removed, and failed counts on the audience Exports tab, or open the Activity tab on the journey Destination Node. See Export an audience or Monitor a journey for more information.
Congrats on successfully exporting to Intercom!
Troubleshooting
These are the issues we see most often. You can always email us at [email protected] for help.
| Problem | Cause | Resolution |
|---|---|---|
| OAUTH Token is empty after you return to GrowthLoop | Intercom did not finish authorization, or the token was not generated | Authorize GrowthLoop again in Intercom. Confirm the token exists in your Intercom account, then reconnect |
| The destination is on the wrong team | Team does not match the GrowthLoop team you intended | Edit the destination and select the team your user belongs to |
| Rows fail to export | Intercom External ID or email is missing | Map Intercom External ID and include the contact's email on the row |
| You cannot find an Intercom segment for the audience | GrowthLoop writes a custom attribute, not an Intercom segment | Open the contact in People and check flywheel_segment_id. Create an Intercom segment that filters on that attribute |
| The contact is missing in People | Email did not match, or the contact is still archived | Confirm the email on the row matches Intercom. Search again after the export completes |
Updated 12 days ago
