> For the complete documentation index, see [llms.txt](https://docs.getkolla.com/kolla/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getkolla.com/kolla/connector-guides/intercom.md).

# Intercom

## Setup Guide

You can create your Intercom app in the [Intercom Developer Hub](https://developers.intercom.com/).

You'll need the following information to set up your Intercom App with Konnect:

* Client ID
* Client Secret

### Prerequisites

* Developer account with [Intercom Developer Hub](https://developers.intercom.com/)

### Create an Intercom app

1. In the Intercom Developer Hub go to the `Your Apps` section
2. Click on the `New App` button and name your app
3. Select `Public App` type and then click `Save`

### Configure your Intercom app

1. Go to your App Details page and navigate to `Configure > Authentication`
2. Click the `Edit` button and check the box under the OAuth section titled `Use OAuth`
3. Click on the `Add Redirect URL` button and add the Konnect OAuth Redirect URL:\
   `https://connect.getkolla.com/oauth`
4. Navigate to `Configure > Basic Information` and note the Client ID and Client Secret for later
5. Add any permissions you will need for your integration in the `Authentication` section

{% hint style="warning" %}
Note: Intercome requires you to submit your app for approval before you can connect to your customers' accounts. It will let you test on your own account to start
{% endhint %}

### Add your Intercom app to Konnect

Get the following information from your Intercom App

* Client ID
* Client Secret 

Login to your Kolla admin portal and go to Connectors. Click on "Add New Connector" and select Intercom from the list of available connectors.

Input all the data from the previous steps and click "Create"