Keys / Intercom
INTERCOM_API_KEY
The access token of a private Intercom app, which your app calls the Intercom API with for your own workspace.
- Expires
- the docs don't say
- API
- revoke only, by uninstalling the app with its own token; no create
Get it
Create one on app.intercom.com/a/apps/_/developer-hub. The steps aren't recorded yet.
Set it
INTERCOM_API_KEY=...
The official Node.js and Python SDKs read it from this variable when you don't pass token. Or keep it out of .env with keypin: keypin run -- npm run dev
Replace it
- Have a teammate with the conversation access the app needs do this step. The new token is limited to that teammate's conversation access, not just the app's scopes.
- In the Developer Hub, open your app, click Test & Publish, select the workspace and click Regenerate token.
- Deploy the new token everywhere that reads
INTERCOM_API_KEY. The docs don't say how long the old token keeps working, so deploy it right away.
Set rotate_every on the key in keypin.toml and a rotated date on its vault item, and keypin status shows when it's due.