Keys / Netlify

NETLIFY_AUTH_TOKEN

The Netlify personal access token the Netlify CLI deploys with in CI, and your scripts call the API with.

Expires
you choose when you create it
API
none; dashboard only

Get it

Create one on app.netlify.com/user/applications. The steps aren't recorded yet.

Set it

NETLIFY_AUTH_TOKEN=...

Netlify CLI reads it before its stored login; elsewhere, the app passes it in. Or keep it out of .env with keypin: keypin run -- npm run dev

Replace it

  1. Create a new personal access token. If the old one could reach a SAML team, allow that again.
  2. Deploy it everywhere that reads NETLIFY_AUTH_TOKEN.
  3. Check that nothing still uses the old token, then select Options > Delete personal token.
  4. Resetting your Netlify password invalidates every token, so plan a reset like a replacement.

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