Overview
Credential versions let you prepare updated credentials for a Marketplace integration without immediately changing the version that the integration uses. Create and test a draft version before you make it active.
This article applies when the Credential Versions section is available for the credential you are updating. For information about adding a credential or testing an integration, see Using Marketplace integrations.
Create a credential version
- In the Dashboard, go to Integrations > Credentials.
- Select the credential you want to update.
- Next to Credential Versions, select + Add version.
- Enter the new API key, then create the version.
The new version is saved as a draft. The credential continues to use its current version until you activate a different one.
Test a credential version
You can test a draft version before activating it.
- In Credential Versions, hover over the version you want to test. The Test button appears only while you hover over the version.
- Select Test.
- In the testing panel, select an operation and enter the required inputs.
- Run the test and review the response.
The test uses the version you selected. Test requests create Integration Logs, where you can review the operation, status code, and response body.
Activate a credential version
When you are ready to use a draft version, make it the active version.
- In Credential Versions, select the … (more options) button next to the version.
- Select Set as Active.
The credential then uses that version for subsequent integration requests. The active badge in Credential Versions identifies the version currently in use.
You can activate another saved version later if you need to change the version in use.
Delete a credential version
To remove a version you no longer need, select the … (more options) button next to the version, then select Delete. You cannot delete the active version. Activate another version first if you need to remove the version that is currently in use.
Troubleshoot credential versions
If a test fails, open the related Integration Log and review its status code and response body. Failures can result from expired or invalid third-party credentials, incorrect request inputs, or third-party configuration changes.
Plans Explained
Marketplace integrations by plan
| Startup Program | Essential Plan | Growth Plan | Enterprise Plan | |
|---|---|---|---|---|
| Marketplace integrations | Not Available | Not Available | Limited | Available |