Create and revoke access tokens
Give a tool, a script or CI your organisation's design systems with a token, and revoke it when it's no longer needed.
An access token lets a tool use your organisation's design systems and templates on your behalf: Figma, Codex, Claude, the MCP server, the pfdl command line (as PFDL_TOKEN) and CI. Design Language Connect doesn't need one from you: it signs in and creates its own.
Who can make which
- Anyone signed in to an organisation can create tokens for themselves.
- A token can't have a higher role than yours, and goes up to publisher at most. Organisation settings always need a person signed in.
- A token never does more than its owner can now: if your role goes down, or you leave the organisation, your tokens follow.
- Admins see and can revoke every token in the organisation; everyone else sees their own.
- Tokens can't be created from a support session.
Create a token
- Open More › Access tokens (
/admin?tab=tokens). - Under New access token, fill in:
- Name: the tool that uses it, such as Figma or Codex.
- Role: viewer is enough for reading design systems. Choose a higher one only when the tool changes things.
- Expires after (days): between 1 and 365. The default is 90.
- Choose Create token.
- Copy the token now with the copy button. It isn't shown again.
Tokens start with pfdl_. Store one where the tool runs, such as a secret in your CI named PFDL_TOKEN. Never commit a token to a repository.
Use a token
pfdlcommand line and CI: set the environment variablePFDL_TOKEN.- MCP clients: send the header
Authorization: Bearer <token>. See The MCP server. - Design Language Connect: if your browser can't reach the approval page, choose Paste a token. See Sign in to Connect.
Revoke a token
- Open More › Access tokens.
- Find the token in the table and choose Revoke.
- Confirm with Revoke. Tools using the token stop working at once.
The table shows each token's role, when it was last used and when it expires, so you can spot ones nobody uses. Tokens that Connect created are named "Design Language Connect · computer"; revoking one signs that computer out.
If something goes wrong
| What you see | What to do |
|---|---|
| Access tokens aren't in your organisation's plan | Tools can't use your organisation's design systems, and existing tokens don't work. Your admin can ask to have them added to the plan. |
| The role you need isn't in Role | The list stops at your own role. Ask an admin to change your role. |
| A tool says the token isn't valid any more | It expired or was revoked. Create a new one and replace it in the tool. |
| You lost a token before copying it | Revoke it and create a new one. |