Access Postman Vault

View as Markdown

With Postman Vault, you can store secrets in your Postman Local Vault. When you first open your local vault, Postman generates a vault key for you to save in a secure location to unlock it later. Your vault key isn’t synced to the Postman cloud. You can reset your vault key if you lose it.

Open Postman Vault

Your local vault is created by default and you can’t delete it. With your local vault, you can store vault secrets in your local instance of Postman. Only you can access vault secrets in your local vault, and they aren’t synced to the Postman cloud. Local vault is supported in all workspace types.

To access your local vault, do the following:

  1. Open a workspace.
  2. Click Vault in the footer.
  3. Create a vault key, if you haven’t already.

Once you create your vault key, you’ll use it to unlock your local vault each time you sign in to Postman. Learn more about unlocking your local vault.

With your local vault, you can also link vaults secrets with secrets stored in an external vault, like 1Password. Learn more about Postman Vault integrations.

Vault secrets aren’t preserved in your Postman Local Vault when you sign out of Postman, switch between the Postman desktop and web apps, or switch to a different machine. Your vault secrets can’t be recovered with your vault key.

To save your vault secrets for later, learn how to export and import vault secrets.

Create your vault key

Save or download your vault key to a secure location so you can unlock your Postman Vault later. Your vault key isn’t synced to the Postman cloud. You can store your vault key in your system’s password manager, such as Keychain Access on macOS, so Postman automatically enters your vault key when you sign in. You can reset your vault key if you lose it.

To save your vault key, do the following:

  1. When you open your local vault for the first time, save or download your vault key to a secure location. You can do the following to save your vault key:

    • Click Copy icon Copy Vault key to copy your vault key to your clipboard.
    • Click Download icon Download Vault key to download your vault key.
  2. By default, Postman stores your vault key to your system’s password manager. If you don’t want to store your vault key in your system’s password manager, clear the checkbox next to Save this key to native password manager.

    If you’re using the Postman web app, you must use the Postman Desktop Agent to save your vault key to your system’s password manager.

  3. Click Open Vault.

You can copy and download your vault key again later. Click Setting icon Settings in the upper right corner, then copy or download your vault key from the Settings tab.

Once your vault key is generated, you’ll use it to unlock your local vault when you sign in.

Reset your vault key

You can reset your vault key if you lose it. Vault secrets are deleted from your Postman Local Vault when you reset your vault key.

To reset your vault key, do the following:

  1. Sign out and sign back in to Postman.
  2. Open your local vault.
  3. Click Reset vault.
  4. Click Reset Vault to generate a new vault key.
  5. Save your vault key.

Unlock your local vault

Each time you sign in to Postman, you must enter your vault key to unlock your Postman Local Vault. You can enter your vault key in the following ways, depending on how you saved your vault key:

  • If you stored your vault key in your system’s password manager, Postman automatically retrieves and enters your vault key when you sign in. Make sure to use the Postman Desktop Agent if you’re using the Postman web app.
  • If you stored your vault key to your own secure location, you must manually enter your vault key and click Open Vault.

Postman recommends you use the latest version of the Postman Desktop Agent to receive recent changes and improvements to Postman Vault.