The Intercom Developer Platform is a suite of SDKs and APIs for building apps that connect with Intercom. You can use these apps to extend the functionality of Intercom or to integrate Intercom with other services.

New to Intercom?

For more information about Intercom products, visit our main website or read our user documentation.

Install Intercom

Install the Messenger into your product for web or mobile. This will allow your customers to send messages to your Intercom Inbox and provide a way for you to test Messenger integrations.

You can also:

For Public App Developers

Public apps (sometimes referred to as integrations) are apps that are available for any customer to install. These apps have access to other peoples' Intercom data, which means there are specific requirements in order to publish them, such as setting up OAuth and submitting to the Intercom team for review.

Set up a development workspace

To develop a public app you will need to use a development workspace: sign up here to create your free account.

This will give you access to your Developer Hub, where you can configure webhooks, define your endpoints for Messenger and Inbox apps, set up OAuth, and submit your app for review.

Development Workspaces vs. Paid Workspaces

Development workspaces have limitations listed here and do not have the full functionality of a paid Intercom workspace. Development workspaces are only available for the US region.

Build your app

Here's the fun part! Build your app using any stack you'd like. For apps that are sent via the Messenger or available for the teammates in the Inbox, you'll need to use our Canvas Kit framework.

To see how it works, try building an app for Inbox or building an app for Messenger.

You are also required to set up OAuth so that your app has permission to access and interact with customers' data.

We recommend creating a [Staging] or [Dev] app and a [Production] app to assist in the development process.

Submit for review

Once development is done and OAuth is configured, in the Developer Hub of your [Production] app you can choose the listing type, provide installation URLs, and follow the steps outlined in this guide to submit it for review.

Make sure that your app follows our developer terms and platform guidelines. Once it's approved, your app is ready to be used by any of Intercom's 25K+ customers.

For Private App Developers

Private apps are apps that you can build specifically for your Intercom workspace that only access your own data. You can build a private app using your Access Token and it does not require a review.

Install apps from the App Store

Your team probably needs to integrate with other tools; we might have an app for it. Install connectors to tools you already use, like:

Available apps can be discovered and installed in the Intercom App Store, including apps built by Intercom, and apps built by other companies.

Build your own integration

If you aren't able to find an existing app that solves the problem you're facing, you can build your own using our REST APIs and Canvas Kit framework.

Go to the Developer Hub and create a new app. Make sure it's associated with your main Intercom workspace from the dropdown. Then you can use the Access Token from that app to start building.

Your app can be whatever you want — to see how it works, try building an app for Inbox or creating your own reports using the API. You can find more guides to help you build under the Guides section in the sidebar.

Configure your app

Your app should already be installed on the workspace where you created it. To uninstall the app, add it to another workspace, or regenerate the token, go to Your Workspaces in your Developer Hub — this guide will show you how. You can start using your app right away, and no review is required for a private app.

Getting help

Let us know

If you have any feedback on our developer documentation, please let us know what you think in the forms at the bottom of each page. Report issues with code blocks by clicking the feedback icon in the top right of the block.

Join our Intercom Community to get help, chat to Intercom experts, and connect to other developers building with Intercom. If you need immediate assistance, contact Intercom customer support directly using the Messenger in the bottom right of this page.