You'll need to set up an Intercom account in order to get started. If you are wanting to use Intercom's full functionality, or have your own workspace already, then signup/login through our usual page here and move on to the next step.
Alternatively, you can create a new developer workspace which is totally free and intended for development purposes only.
Developer Workspace Limitations
These free workspaces we provide you will not have all the functionalities of a standard Intercom production workspace. These limitations include:
- No outbound emailing.
- Help Center Sites that can never be set live.
- A watermarked Messenger, showing that it's linked to a Developer Workspace.
- A maximum of 20 users/leads (if you have more than 20 users/leads, the oldest extras will be archived automatically on a regular basis).
Now that you have your workspace, it's time to create your first app in the Developer Hub.
Everything is an app
Anytime you want to interact with the Intercom Platform–via the REST API, webhooks, or to build an app for the Messenger–you start by creating an app. Apps are like containers for the various functionality that you have access to on the Intercom Platform and each app can be managed and installed to your other Intercom workspaces independently.
On the Your Workspaces page, you can manage where your app is installed, and view your Access Token for each workspace.
You can also view your Access Token on the Authentication page, which provides greater details alongside OAuth settings.
Access Tokens or OAuth
An Access Token is used to access your own workspace data via the API. You should never give your Access Token to a 3rd party. If you're building an app that's destined to be used only by your own teams in your own workspaces then using your Access Token is generally sufficient.
However, if you plan to make your app publicly available on the Intercom App Store you'll need to set up OAuth. But don't worry, you can always decide to set up OAuth at a later date. For more information on authorization and setting up OAuth take a look at the guide here.
Test out your app's Access Token by making a call to our API, or build a functional app in the Messenger within 30 minutes.
|Make an API call|
|Build your first Messenger app|