Intercom Extract authentication guide

​​

Overview

This is a step-by-step guide to creating an OAuth entry, acquiring credentials and authorising the Intercom Extract connector for use in Matillion ETL.

Important Information

• The Intercom Extract connector uses an OAuth for third-party authentication.
• While connector properties may differ between Cloud Data Warehouses, the authentication process remains the same.

---

Creating an OAuth Entry in Matillion ETL

1. In Matillion ETL, on the top left of the screen, click Project → Manage OAuth.

   Please Note

   If a Intercom Extract connector has already been added to an Orchestration Job, the Manage OAuth window may also be accessed using the following method:

   1. Click the connector icon to open the Properties panel at the bottom of the screen.
   2. Then, click ... next to the OAuth input, and finally click Manage in the pop-up window.
   

   Project dropdown menu

2. Copy the Callback URL in the field at the top of the window as this will be required in Acquiring Third-Party Credentials.

3. Click + in the bottom left of the window to open the Create OAuth Entry window.

   

   New OAuth entry

4. Click the Service dropdown menu and select Intercom. Then, provide a name for the OAuth in the Name field and click OK.

   

   Create OAuth Entry window

5. On returning to the Manage OAuth window, check the list of OAuths to ensure the new entry is listed.

   Please Note

   This entry is Not Configured. Configuration of the OAuth entry will be discussed in Authorising for use in Matillion ETL.

   

   New Entry listed on Manage OAuth window

​

---

​

Acquiring Third-Party Credentials

1. Navigate to the Intercom Developer Hub and click Your Apps on the right above the header. The browser will then redirect to a login screen. Enter valid login credentials to continue.

   

   Intercom Developer Hub

2. Once logged in, the Your apps page will open. Next, in the main body of the page, click New app.

   

   Your apps

3. The New app pop-up window will open. Provide details for the following fields:

   • App Name: provide a descriptive name for the app
   • Workspace: select a workspace in which to add the app
   • Select whether the app be an Internal integration or a Public app, then click Create app
   

   New app

4. The browser will then redirect to the Authentication window of the newly created app's dashboard. In the top right corner of the window, click Edit.

   

   Authentication

5. Now, in the OAuth section, tick the checkbox next to Use OAuth. Then, click + Add redirect link, paste the Callback URL (copied from the Manage OAuth window in Matillion ETL earlier) into the Redirect URIs field, and click Save in the top right corner of the window.

   

   Paste the Callback URL

6. Next, on the sidebar on the left, click Basic Information. Then, copy the codes below Client ID and Client secret as they will be required in Authorising for use in Matillion ETL.

   

   Copy Client ID and Client secret

---

​

Authorising for Use in Matillion ETL

1. Return to the Manage OAuth window in Matillion ETL and click next to the previously created OAuth entry. This will open the Configure OAuth window.

   

   Configure OAuth settings

2. Using the codes copied from the Intercom website earlier, provide details for the following fields:

   • Client ID – enter the Client ID
   • Client Secret – enter the Client secret, then click Next
   

   Configure OAuth settings

3. The next window will have an Authorization link. Click the link to authorise Matillion ETL to use the acquired credentials.

   

   Authorization link

4. The browser will then redirect to a screen requesting access to the associated Intercom account. At the bottom of the screen, click Authorize Access to confirm.

   

   Allow access to Intercom account

5. If all is successful, the browser will return to Matillion ETL with a window stating, "Authorization Successful".

   

   OAuth Authorization successful