Skip to content

Manage apps ​


Contents ​


1. Scenarios ​

Scenario 1: Use a warehouse tool provided by your team ​

Situation: Your team has provided an additional warehouse tool for daily operations. You need to perform warehouse tasks within your assigned permissions.

Use this feature: Open an installed tool.

Result: You use the organization’s tool within your operation permissions and assigned warehouse.


2. Features ​

Open this page from “Advanced” → “Apps” → “Manage apps” in the sidebar.

This page lists apps installed for your organization. No merchant selection is required. You can open a tool or stop its access. Users with integration management permission can browse and install apps after reviewing their permissions, and can check installed apps for updates and upgrade them in place. Changing the header merchant does not change this list. Online App operations follow your current operator permissions and assigned warehouse.

Apps - Page overview

2.1 Open an app and check availability ​

The “Current version” column shows the installed version, such as 1.0.2. It changes only after you confirm an upgrade; publishing a new store version does not change it. “—” means no version record is available.

Opening an app requires integration viewing permission. Expand “Apps” in the sidebar and select an installed app by name. Select “Manage apps” to return to the installation list. You can also select “Open” from the list.

The app fills the console’s content area, with the sidebar retained. Use “Manage apps” in the sidebar or your browser’s Back button to return. You can bookmark this page or open it in a new tab; reloading checks your current access again.

“Available” allows opening; “Suspended” does not. An empty list means this organization has no installed apps. Contact the team that provides the tool.

Online organization app operations follow the current operator’s permission and warehouse. Merchant data such as orders, inventory, inbounds, returns and products is limited to the merchants assigned to that operator. Picking lists are not restricted by the header merchant filter or merchant assignments. Background jobs authorized by installation consent can access warehouses across this organization. Uninstalling stops further access.

If the app version declares inventory change, order shipped or order cancelled notifications and you grant the event subscription and the matching read permissions (inventory read for inventory changes, order read for shipped and cancelled orders), installation creates the subscription automatically and it takes effect immediately. The subscription covers the whole organization: inventory changes, shipped orders and cancelled orders for any merchant in this organization are sent to the app, and each notification identifies its merchant. Events before installation are not replayed; uninstalling stops notifications. Delivery records of these notifications are visible only to operators assigned to that merchant, not in the merchant console.

2.2 Uninstall ​

Integration management permission is required. Select “Uninstall” and confirm to remove the app from the organization’s list and sidebar and invalidate its existing access. Uninstalling does not cancel orders or change inventory, and order flags the app already wrote are kept. Follow the installation flow to install it again.

2.3 Install from App Store ​

  1. Select “Browse App Store” to open App Store in the same tab with the current installation owner.
  2. Open an app’s details and select Install to return to this page. In the confirmation dialog, review the app icon and name, publisher, “Install for” and requested permissions. Expand “Details” to view the version and app domains.
  3. Enable “I agree to grant these permissions.”, then select “Agree and install”. After installation, the new app opens right away and also appears in the installed list and sidebar. Some apps only start working in the background (for example, processing new orders automatically) after they have been opened, so installation takes you straight into the app.

Operator installations belong to the current organization; no merchant selection is required.

Selecting a version does not install it. Cancelling grants no permissions and does not affect existing tools. If the app already has an active installation, choosing another version does not overwrite it; use Check for updates and upgrade to update an existing installation.

▸ Installation blocked by the organization plan ​

The confirmation dialog checks the organization plan first. Two conditions block installation: the dialog shows a warning explaining the reason and the current organization plan, without the “I agree to grant these permissions.” switch or the “Agree and install” button, and “Cancel” is the only action.

  • The app declares a minimum plan: installation is blocked when the current organization plan is below it. Plans from lowest to highest are “Standard”, “Advanced”, “Pro” and “Enterprise”; “HCT Advanced” counts as “Advanced”.
  • The organization plan does not include Vanta Connect integrations: apps installed here are always organization apps and always require a plan that includes the Vanta Connect integrations feature (“Standard” does not), whether or not the app declares a minimum plan.

After upgrading the plan, start the installation again from App Store. Installed apps are not affected by plan changes, and a later downgrade does not remove an existing installation; however, an organization app’s calls to the Vanta Connect API still depend on whether the current plan includes that feature.

2.4 Check for updates and upgrade ​

  1. Users with integration management permission can select “Check for updates” beside an app.
  2. Compare “Current version” and “Latest version”. When an update is available, confirm that “Install for” shows your current organization, then review the publisher, all requested permissions and app domains. New permissions are marked.
  3. Enable “I agree to the permissions for this version and confirm the upgrade” at the bottom of the dialog, then select “Confirm upgrade”. The consent switch and action buttons stay visible while you scroll through the details. The app then opens again; you will be guided through connection authorization if needed.

Checking does not modify the installation. Upgrading preserves the installation and the organization’s integration credential, applies the new permissions and organization-level event subscriptions, and invalidates existing windows and authorizations. The app then reopens so it can reconnect on the new version. If there is no update or the destination platform does not support it, the dialog explains the result without offering upgrade confirmation.

Confirmation expires after five minutes. If the release is withdrawn, the installation or permissions change, or the login session expires, check again and review before confirming. If the new release requires capabilities that only merchant installations can use, confirmation is refused and the installation stays unchanged. A failed check never triggers an automatic upgrade. Ask an administrator for help with legacy installations that have no App Store version mapping.

2.5 App credentials and webhook ​

The API credential and event subscription an app receives at installation are viewed and maintained only on this page. They do not appear in the Vanta Connect integrations credential list.

The “Webhook” column shows whether events are being sent: “Connected” means events reach the app; “Deactivated” means nothing is sent right now; “Not subscribed” means this app version declares no event notifications.

Select the expand icon at the left of a row to review what the app was granted. “Granted scopes” lists the permissions approved at installation. Organization apps use a “Vanta Connect credential”. The “Webhook URL”, “API version” and “Subscribed events” come from the app version. They can’t be edited here, and the signing secret can’t be regenerated. To change them, upgrade the app.

▸ Reactivate an auto-deactivated subscription ​

When 10 events in a row fail to reach the receiver (each one counts only after all automatic retries are used), the system deactivates the subscription and notifies the organization’s operators. Expand the row to see “Consecutive failures” and “Last delivery”.

  1. Ask the team that provides the app to fix the receiver first.
  2. A user with integration management permission selects “Reactivate subscription” and confirms.
  3. The status returns to “Connected”, the failure count resets, and inventory changes, shipped orders and cancelled orders in this organization are delivered again. Events during the deactivated period are not replayed.

Reactivation is not possible when the app is uninstalled, suspended or taken offline, when its credential is inactive, or when its grant no longer includes the event subscription permission. The page explains the reason and the subscription stays deactivated.

▸ Test delivery and delivery log ​

While the subscription is active, a user with integration management permission can select “Send test delivery” to send one test event to the app’s webhook URL. The page shows the receiver’s HTTP status and the time taken. An error response shows its status code; a failed connection or no response within 20 seconds is reported as a connection failure or timeout. Test deliveries are recorded as manual; the one you send is not retried automatically and does not count toward consecutive failures.

“View deliveries” opens “Webhook Logs” filtered to this subscription. Select “Show all” to return to the full list. The button appears only with log viewing permission. Event deliveries remain visible only to operators assigned to the event’s merchant. Test deliveries belong to no merchant and appear only in the subscription list opened from “View deliveries”. Every operator in the organization who can view Webhook logs sees them there, whatever merchant is selected in the header.


3. FAQ ​

3.1 Questions ​

▪ What if an app reports too many requests? ​

Wait before trying again and avoid repeated retries. If the problem continues, share the app name and error message with its development team. Each app has separate allowances for each organization: 10 requests per second, 180 per minute, and 10,000 per day. If its daily allowance is exhausted, wait until midnight in the organization’s timezone. Signing in again or reinstalling does not reset usage.

▪ Why is an app missing? ​

No merchant selection is needed. If the list is empty, ask the team to check that the app is installed for your current organization. If the menu is missing, ask an administrator to check integration viewing permission.

▪ What should I do when the app expires? ​

Reload the page in your browser, or return to the list and open the app again. Changing warehouses, signing out, changing permissions or uninstalling can invalidate an existing window. Closing it does not undo completed operations; check saved results before retrying.

▪ What if an app does not load? ​

If the installation list does not load, select “Reload apps” to reload it. A loading indicator appears while the app connects. If it has not connected within 15 seconds, an error screen offers “Reload apps” to open it again. If it still cannot open, share the app name and error message with the team that provides it.

▪ Why can’t I select Browse App Store? ​

Ask an administrator to check that you have integration management permission.

▪ What if confirmation expires or installation fails? ​

After signing out, changing accounts or losing permission, select the app and version again. Retry temporary connection failures; if a version has been withdrawn, select another available version. If the store cannot open, ask an administrator to check the App Store connection settings. Share persistent errors with an administrator.

▪ The dialog says a specific plan or a plan with Vanta Connect integrations is required and installation is not possible. What should I do? ​

The current organization plan does not meet the app’s installation conditions. This is not an installation failure, and retrying does not change the result; see Installation blocked by the organization plan for the conditions. Select “Cancel”, ask an administrator to upgrade the organization plan, then start the installation again from App Store. Other existing apps are not affected.

▪ Does an installed app automatically move to its new website? ​

It does not change automatically. An installed app keeps the name, description and version selected at installation. Later store edits or publications do not change the version or website origin of your existing installation. To use an approved new version, use Check for updates and upgrade, review the new domains and requested permissions, and explicitly confirm; the existing installation and integration credential are kept rather than replaced. Upgrading invalidates old windows and authorizations; the app then reopens automatically.

▪ Why is an app name or action button in another language? ​

App names and action buttons use translations included with the installed app. When no matching translation is available, the app’s default language is shown. Traditional and Simplified Chinese do not automatically substitute for each other; either may still appear if the app uses it as its default language.

▪ I was notified that a webhook was auto-deactivated and the app gets no events. What should I do? ​

Auto-deactivation happens only after repeated delivery failures. Ask the team that provides the app to fix the receiver, then follow Reactivate an auto-deactivated subscription. You can use a test delivery first to confirm the receiver is back. Uninstalling and reinstalling is not necessary.

▪ Why can’t I reactivate the subscription? ​

The page states the reason: the app is uninstalled, suspended or taken offline, its credential is inactive, or its grant no longer includes the event subscription permission. For the first two, contact the team that provides the app; for missing permission, upgrade to an app version that includes it, or contact the team that provides the app. If the button can’t be selected, ask an administrator to check that you have integration management permission.

3.2 Notices ​

⚠️ Important ​

  • Uninstalling stops the app’s access immediately. Reinstalling does not restore access for old windows. To move to a new version, use Check for updates and upgrade instead of uninstalling.
  • Events that happen while the subscription is deactivated are not replayed after reactivation.
  • A plan downgrade does not remove installed apps, but an organization app’s calls to the Vanta Connect API stop once the plan no longer includes that feature.

FeaturePurposeLink
Order listSelect orders for a bulk toolOpen
Order detailsCheck order progressOpen

Last updated 2026-11-16 19:57