Skip to main content

How to use access tokens

Access tokens let other tools connect to your Pastel account. You create a token in Pastel, then paste it into the tool that needs it. That tool can then work with your Pastel data until the token expires or you revoke it.

Written by Valentin Staykov

What a token can access

Each token works with one of three things:

  • Pastel API. For your own scripts and for services like Zapier that call the Pastel API.

  • MCP. For AI assistants that connect to Pastel over MCP.

  • CLI. For the Pastel command-line tool.

A token made for one of these won't work with the others. If you use the API and the CLI, create a token for each.

You can have as many tokens as you like. We recommend one token per tool. That way you can revoke a single token without breaking anything else.

Create a token

  1. Click New personal token.

  2. Give the token a name that tells you where it's used, like "Zapier export".

  3. Choose what the token is for: API access, MCP, or CLI.

  4. Pick an expiration date. A token can last anywhere from 7 days to 1 year.

  5. Click Create token.

  6. Copy the token and store it somewhere safe, like a password manager.

Pastel only shows the token once. If you lose it, revoke it and create a new one.

Use your token

Paste the token wherever the tool asks for it. Setup depends on what the token is for:

  • Pastel API. See the Pastel API documentation for how to authenticate requests.

  • MCP. See Connect Pastel to an AI assistant.

  • CLI. See Get started with the Pastel CLI.

Treat a token like a password. Anyone who has it can access your Pastel account through that tool, so don't share it in chat, email, or public code.

Expiration

A token stops working on the expiration date you picked when you created it.

See and revoke your tokens

The Integrations settings page lists every service with access to your account and when it last used that access.

To cut off a service, click Revoke next to it. Do this right away if you think a token has leaked, or if you've stopped using the tool it was made for.

Still using a legacy API token?

Legacy API tokens stop working on February 15, 2027. Follow the steps in Legacy API tokens are being replaced to switch to an access token before then.

Need help?

Did this answer your question?