Export and import vault secrets

Exporting and importing vault secrets is in open beta on Postman Free plans.

Since vault secrets are only available locally, they aren’t preserved when you sign out of Postman, switch between the Postman desktop and web apps, or switch to a different machine. Export your vault secrets from your Postman Vault to preserve them in a JSON file for later, either in encrypted or plaintext format. Then import your vault secrets back in to your Postman Vault after you’ve signed in or switched to a different Postman app or machine.

As a Team Admin on a Professional or Enterprise plan, you can manage whether your teammates can export vault secrets. You can also specify if your teammates can export vault secrets in encrypted or plaintext formats.

Export vault secrets

1. Open your Postman Vault.

2. Click View more actions in the upper right of your Postman Vault, then select Export.

3. Choose how you’d like to download your vault secrets:

   • Encrypted (recommended) - Download your vault secrets in encrypted format. Set a password with a minimum of 12 alphanumeric characters. Postman requires the password when importing the JSON file into Postman.
   • Unencrypted - Download your vault secrets in plaintext format.
   

   If you’re on a Professional or Enterprise plan, a Team Admin may have restricted options for exporting your vault secrets.

4. Click Export to download your vault secrets as a JSON file.

Import vault secrets

You can import vault secrets into your Postman Vault using the JSON file you downloaded when exporting your vault secrets.

To import vault secrets into your Postman Vault, do the following:

1. Open your Postman Vault.

2. Optionally, you can clear all of the vault secrets from your Postman Vault. Click View more actions in the upper right of your Postman Vault, select Clear, and click Clear to confirm.

3. Click Import in the sidebar.

4. Select or drag a file or folder, enter a link to a specification file, paste raw text, or import from a remote repository.

   Vault secrets created with a Postman Vault integration are only supported in the Postman desktop app. After importing your vault secrets, you’ll need to reauthenticate with your external vault from the desktop app.

5. If you’re importing vault secrets from an encrypted JSON file, enter your password.

6. Click Import.

7. Postman notifies you if you’re importing duplicate vault secrets. You can take the following actions:

   • Select the checkbox next to Apply to all number of vault secrets conflicts to apply the same decision (replace or keep) to multiple vault secrets you’re importing.
   • Click Replace to delete the existing vault secret with the same name and replace it with the new vault secret.
   • Click Keep to keep the new and existing vault secrets with the same name. In your Postman Vault, the existing vault secret has a warning icon next to its name, indicating that it’s being overwritten by the new vault secret.

Manage exporting vault secrets

Managing whether your teammates can export vault secrets is supported on Postman Professional and Enterprise plans.

As a Super Admin or Team Admin, you can manage whether your teammates can export vault secrets from their Postman Vault.

1. Select Team > Team Settings in the Postman header.

2. Click Team resources in the sidebar, then click Vault.

3. Turn on Vault export to allow your teammates to export their vault secrets.

4. Choose the following:

   • Select Allow encrypted export to allow your teammates to export vault secrets in encrypted format, requiring a password to import into Postman.
   • Select Allow unencrypted export to allow your teammates to export vault secrets in plaintext format.
   

5. Click Save.

To prohibit your teammates from exporting vault secrets in any format, turn off Vault export.