Skip to main content
Connect Intercom to Oleria to see which teammates can administer your Intercom workspace, which roles and teams they hold, and what admin actions they take.

​
What Oleria discovers

  • Users - Intercom admins (teammates), from the admin list
  • Roles - the role catalog, derived from each admin’s assigned role
  • Teams - Intercom teams, mapped as groups, and each admin’s team memberships
  • Activity - admin activity-log events (audit trail of admin actions in the workspace)

​
Prerequisites

  • Administrator permission on the Oleria workspace.
  • Access to your Intercom workspace’s Developer Hub.
Oleria’s Intercom integration supports workspaces on Intercom’s US data region only. EU and Australia region workspaces aren’t supported - connecting one fails at authentication.

​
Create a private app access token in Intercom

1

Open the Developer Hub

Sign in to Intercom and go to the Developer Hub, then open (or create) an app for this integration.
2

Grant scopes

Under Configure -> Authentication, grant the app the following scopes:
  • read_admins
  • read_admin_activity_logs
3

Create the access token

From the same Authentication page, create an Access Token. Copy it now - Intercom shows it only once.

​
Connect Intercom to Oleria

1

Open the integration

Sign in to your Oleria workspace, navigate to Integrations, and select Intercom.
2

Complete the connection form

Fill in the connection form:
Authenticate also reads your Intercom teams and workspace details, and fails if the credential can’t read them.
3

Authenticate

Select Authenticate to complete the connection.

​
Verify the integration

Confirm the Intercom instance appears on the Connected tab of your Oleria Integrations page with a status of Healthy. After the first sync completes, you can review the discovered admins, roles, teams, and admin activity in your Oleria workspace.

​
Known limitations

  • Intercom exposes no dedicated roles endpoint, so the role catalog is derived from the roles observed on admin accounts rather than fetched directly.
  • No remediation actions. Intercom’s API has no admin create, disable, suspend, or role/team-change operation. Oleria doesn’t perform any account or access changes for this integration - teammate lifecycle, roles, and team membership are all managed in Intercom’s own admin console.
  • Contacts and Companies in Intercom aren’t synced as resources - this integration covers workspace access (admins, roles, teams) and admin activity only.

​
Contact us

For questions about this integration, contact us at support@oleria.com.