Note: Access Tokens have replaced API Keys
If you're currently using an API Key to access the Intercom API for your own data, you should switch to using an Access Token asap - API Keys will be fully deprecated in early 2018.
Please note that Access Tokens were formerly called 'Personal Access Tokens'
You'll need an Access Token if you want to use the API to access your own Intercom data – for example, if you use the API with your own scripts to get data from your Intercom account.
If you intend to make an integration available publicly, and therefore need to access other people's Intercom data, you will need to set up OAuth instead.
If you're unsure, use this guide to work out whether you need an Access Token or OAuth.
Setting up Access Tokens
To get more information on how to create your access token please checkout our setup guide
Access Tokens should never be shared outside of your company
Access Tokens allow access to your private customer data in Intercom. They should not be shared outside of your company. Integrations requiring access to your Intercom account should be using OAuth – if an integration requests your Access Token, please let us know and don't share your Token with them.