Common Authentication and Marketplace App Troubleshooting Guide
BoldDesk Marketplace apps connect to external services through an authorization process. An installation or authentication error can occur when the authorization session expires, the connected account is invalid, the user lacks permission, an app is already installed, or BoldDesk cannot validate the authorization response.
This article explains how to resolve common authentication and installation messages displayed while connecting Marketplace apps in BoldDesk.
- To install an app, go to Admin > Apps > Marketplace.
- To review or re-authenticate an installed app, go to Admin > Apps > My Apps.
Prerequisites
Before troubleshooting, ensure that:
- Your BoldDesk role can access Marketplace and My Apps.
- You can sign in to the external service.
- Your external account can authorize or manage apps for the required organization, workspace, team, or tenant.
- You know the correct BoldDesk organization domain.
- Browser cookies, pop-ups, and redirects are allowed for BoldDesk and the external service.
Before You Begin
Complete these checks before applying an error-specific resolution:
- Close any incomplete installation or authorization windows.
- Refresh BoldDesk.
- Go to Admin > Apps > My Apps and check whether the app was installed.
- If the app is not installed, restart the installation from Admin > Apps > Marketplace.
- Confirm that the correct external account, organization, workspace, team, or tenant is selected.
- Complete the authorization in the same browser and session.
Do not share passwords, API keys, access tokens, authorization codes, client secrets, signing secrets, or session cookies with BoldDesk Support.
Authentication and Permission Errors
| Error message | How to resolve |
|---|---|
| Access Denied. | Confirm that your BoldDesk role can install or manage the app. Verify that your external account can authorize apps for the selected organization, workspace, team, or tenant. Restart the installation using an account with the required permissions. |
| Authentication failed | Restart the authorization from the app page in BoldDesk. Sign in to the intended external account, complete any verification prompt, review the requested permissions, and approve the connection. |
| The session has expired. Please login again. | Close the expired page, sign in to BoldDesk again, and restart the installation or re-authentication. Do not reuse the expired authorization URL. |
If an installed app provides a Re-Authentication option, use it to refresh an expired or interrupted connection.
For Slack, go to Admin > Apps > My Apps, open Slack, and click Re-Authentication.
Authorization Response Errors
| Error message | How to resolve |
|---|---|
| Access denied: Invalid authorization token | Restart the connection from BoldDesk. Sign in to the external service again and approve the requested permissions. If the app requires a manually entered API key or token, replace it with a valid credential from the external service. |
| Access denied: Invalid authorization code | Close the authorization window and start a new installation or re-authentication attempt from BoldDesk. Authorization codes are temporary and should not be reused. |
| Access denied: Invalid authorization state | Close all incomplete authorization tabs, sign in to BoldDesk again, and restart the connection in the same browser session. Do not open the authorization callback in another browser or device. |
Do not manually edit authorization tokens, codes, or state values. These values are generated during the BoldDesk-managed authorization flow.
Domain Errors
| Error message | How to resolve |
|---|---|
| Domain required | Enter the BoldDesk organization domain requested by the authorization page and submit the form again. |
| Invalid domain name | Confirm the organization URL in the browser and enter the correct BoldDesk domain. Do not enter an email address, Slack workspace URL, or unrelated website address. |
For Slack authorization, enter the BoldDesk domain after approving access in Slack, and then continue with the BoldDesk sign-in and permission steps.
If a valid BoldDesk domain is rejected repeatedly, contact BoldDesk Support.
App Installation and Loading Errors
App Could Not Be Installed
Error message
Due to an internal issue, the app could not be installed. If the problem persists, please contact the administrator.
To resolve the error:
- Go to Admin > Apps > My Apps and check whether the app was installed.
- If the app is not listed, return to Admin > Apps > Marketplace.
- Open the app and restart the installation.
- Complete all required account, action, mapping, and permission settings displayed for the app.
- Save the configuration.
If the same error appears again, contact BoldDesk Support.
App Could Not Be Loaded
Error message
Due to an internal issue, the app could not be loaded. If the problem persists, please contact the administrator.
To resolve the error:
- Refresh the BoldDesk page.
- Go to Admin > Apps > My Apps.
- Search for and reopen the app.
- Confirm that the app is active.
- Use Re-Authentication if the action is available.
- Contact BoldDesk Support if the app page remains unavailable.
Other App Errors
| Error message | How to resolve |
|---|---|
| App already exists | Open the existing app from Admin > Apps > My Apps and update or re-authenticate it. Do not create a duplicate installation. For a custom app, edit the existing app or use a unique app name. |
| App not found | Search for the app under My Apps. If it is not installed, check Marketplace and install it again. |
| Invalid app | Restart the installation from Marketplace and select the intended app. If the app is already installed, open it from My Apps instead of reusing an old installation URL. |
| Validation failed | Review the app configuration for a field-specific message. Complete the required account, mapping, action, and permission fields, and then save again. |
Account and Organization Errors
| Error message | How to resolve |
|---|---|
| Account error: Invalid organization | Confirm that the external organization exists and that the signed-in account can access it. Restart authorization and select the correct organization. |
| Invalid organization | Reopen the app authorization and select an accessible external organization. If the app is already installed, re-authenticate the connection. |
| Account error: Invalid user | Confirm that the external user account is active and can access the selected organization, workspace, tenant, or team. Restart authorization with the correct account. |
| Invalid app user | Sign out of the incorrect external account and restart authorization with an active user who can approve the app connection. |
| Invalid app team | Confirm that the external team still exists and that the authorizing user belongs to it. Restart authorization and select an accessible team. |
| Invalid app tenant | Confirm that the correct tenant is selected and that the signed-in account belongs to it. Restart authorization from BoldDesk. |
If the browser automatically opens the wrong external account, sign out of that account or retry the connection in a private browsing window.
Slack Account-Linking Errors
Slack Account Already Linked to Another BoldDesk Account
Error message
This Slack account is already linked with another BoldDesk account.
This message indicates that the selected Slack account or workspace is already associated with another BoldDesk organization.
To resolve the error:
- Confirm that the correct Slack workspace is selected.
- Confirm that you are signed in to the intended BoldDesk organization.
- Ask an administrator to review the existing Slack installation.
- Remove or update the previous association before connecting the Slack workspace to another BoldDesk organization.
- Restart the Slack installation or re-authentication.
BoldDesk Account Already Linked to Another Slack Account
Error message
This BoldDesk account is already linked with another Slack account.
To resolve the error:
- Go to Admin > Apps > My Apps.
- Open the installed Slack app.
- Review the connected Slack workspace.
- Continue using the existing connection if it is correct.
- If a different Slack workspace is required, update or remove the existing connection before starting another installation.
If the wrong Slack workspace opens during authorization, sign out of Slack or use a private browsing window before restarting the process.
Use the Slack installation method that matches the environment:
- Single Slack workspace
- Slack Enterprise Grid organization-wide deployment
Subscription and Feature-Limit Errors
Feature Limit Reached
Error message
You have reached the limit for this feature in your current subscription plan
To resolve the error:
- Go to Admin > Billing and Subscription.
- Review the active plan.
- Identify the app feature or configuration limit that has been reached.
- Remove an unused configuration where applicable.
- Contact BoldDesk Support if a higher supported limit is required.
Confirm the specific feature and limit before changing the subscription. The error message does not identify which limit was reached.
Zapier Installation Plan Error
Error message
Zapier app can only be installed for starter plan
To resolve the error:
- Review the active plan under Admin > Billing and Subscription.
- Confirm that Zapier is available under Admin > Apps > Marketplace.
- Capture the exact error if installation remains blocked.
- Contact BoldDesk Support to verify eligibility for the organization’s current plan.
After installation, the BoldDesk account is connected in Zapier using the BoldDesk domain and API key.
Success Messages
The following messages confirm successful completion and do not require troubleshooting:
- App successfully installed
- Successfully authenticated
After a success message appears:
- Go to Admin > Apps > My Apps.
- Open the installed app.
- Confirm that the app is active.
- Complete any remaining actions, mappings, permissions, or notification configuration required by the integration.
- Perform a supported test action.
Verify the App Connection
After resolving an authentication or installation error:
- Go to Admin > Apps > My Apps.
- Open the affected app.
- Confirm that the app is active.
- Review the connected account, organization, workspace, team, or tenant.
- Review the app permissions.
- Perform a supported test action.
For Slack, test a configured ticket notification or two-way ticket action.
For Zapier, test the BoldDesk trigger or action from the Zap editor.
Contact BoldDesk Support
Contact BoldDesk Support if:
- The app cannot be installed or loaded after a fresh attempt.
- A valid BoldDesk domain is rejected.
- Authorization repeatedly fails with the correct account.
- A valid organization, workspace, tenant, team, or user is rejected.
- A Slack account association cannot be identified or changed.
- A subscription-limit message appears despite an eligible plan.
Provide:
- BoldDesk organization URL or organization ID.
- App name.
- Exact error message.
- Screenshot showing the complete error.
- Action performed: installation, authentication, re-authentication, or app loading.
- External organization, workspace, tenant, or team name.
- Date, time, and time zone.
- Steps required to reproduce the issue.
Do not include passwords, API keys, access tokens, authorization codes, client secrets, signing secrets, or session cookies.
Related Articles
- Understanding BoldDesk Third-Party App Integrations
- How to Install and Configure Apps in BoldDesk Marketplace
- How to Re-Authenticate Slack in BoldDesk
- How to Install and Configure the Slack Integration in BoldDesk for a Single Workspace
- How to Install the BoldDesk Slack App for Organization-Wide Deployment
- Zapier Integration with BoldDesk
- How to Add and Manage Custom Apps in BoldDesk
