Keys / Trello

TRELLO_API_KEY

The API key that identifies your Trello Power-Up. It's meant to be public; with a user's token it reads and writes that user's Trello data.

Expires
the docs don't say
API
none for keys; tokens can be deleted

Get it

Create one on trello.com/power-ups/admin. The steps aren't recorded yet.

Set it

TRELLO_API_KEY=...

Your app passes it in: requests send it as the key query parameter, next to token, and Trello's Power-Up REST API client takes it as appKey. Or keep it out of .env with keypin: keypin run -- npm run dev

Replace it

  1. The key is public; the token is what to keep secret. If a token leaks, revoke it: the user clicks Revoke next to it in their Trello account settings, or your app calls DELETE /1/tokens/{token}.
  2. Trello's docs don't describe replacing a key. An answer on Atlassian's developer forum says tokens belong to the key that issued them, so with a new key every user must authorize again.
  3. If you switch keys, deploy the new key and the new tokens everywhere that reads TRELLO_API_KEY.

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