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

  1. 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.
  2. In the Developer Hub, open your app, click Test & Publish, select the workspace and click Regenerate token.
  3. 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.

Sources, checked 2026-11-16