Skip to main content

Initial setup for Intercom Reader

The Intercom Reader can authenticate using an API key or OAuth. Choose the option that aligns with your security and operations requirements.

Using an API key

  1. Sign in to your Intercom workspace with an account that has developer access.

  2. Open Settings > Apps & Integrations > Developer Hub, then select your app (or create a new one).

  3. Go to Authentication and copy the access token (API key) for server-side use.

  4. Store the token securely. You will supply it to the Intercom Reader as the API key (or access token) when configuring the source or a connection profile.

Using OAuth (access/refresh tokens)

  1. In the Intercom Developer Hub, open your app and select Authentication.

  2. Enable OAuth and add a redirect URL that you control for the authorization callback.

  3. Save your changes and complete the OAuth consent to obtain an access token (and, if applicable, a refresh token).

  4. Provide the access token to the Intercom Reader. If your flow uses long-running unattended access, supply the refresh token as well so tokens can be rotated without user interaction.

Note

Ensure your Intercom app scopes cover the objects you plan to read (for example, Conversations, Contacts). If a scope or plan level is insufficient, calls to that object may fail.

Setting up a connection profile in Striim

A connection profile stores authentication details and endpoint settings for reuse across applications. Creating a profile avoids re-entering credentials and standardizes your Intercom connectivity.

Authentication for Intercom

Intercom supports two authentication methods with Striim connection profiles: API key (server-side access token) and OAuth. Choose API key for simple server-to-server integrations, or OAuth when you need delegated access and token refresh.

Create a connection profile for Intercom Reader

  1. In the Striim console, navigate to Manage > Connection Profiles.

  2. Click Add Connection Profile.

  3. Enter a clear Profile Name (for example, IntercomProd).

  4. Select Endpoint Type as Intercom.

  5. Select an Authentication Method:

    • API key: Paste the Intercom Access Token (server-side token) into the provided field.

    • OAuth: Click Sign in using OAuth, complete the Intercom login and consent, then close the browser window to return to Striim. The profile stores the resulting access (and refresh) tokens.

  6. Click Test connection to verify credentials and access.

  7. Click Save to create the connection profile.

After saving, reference this profile when configuring the Intercom Reader source in your Striim application.

Note

Striim uses TLS 1.2 or later to encrypt connections. Restrict access to the profile to authorized users only.