Hi there,
I have created a HubSpot app card as part of app integration. But my question is, how do we preview the app card in the HubSpot account (not the developer account) without running the hs project dev command? I have already deployed the latest build, but I’m still getting the error shown in the screenshot below.
FYI- The error I’m getting below is not in the developer account.
Any help is much appreciated!
Best regards,
Athul
Hello @Athul_C,
Thanks for bringing this to the community!
We appreciate that you’ve added the errors that you’re seeing on your end! I’d like to tag in some of our Top Contributors to see if they have any experience with this! @RubenBurdin, @SteveHTM, @GRajput
Do you have any suggestions for @Athul_C regarding testing this in their production portal?
Thank you!
Sam, Community Manager
Hi @Athul_C
"The error usually happens because one of these is missing:
1. Required OAuth scopes are missing or not re-authorized after deployment
2. The app card is rendered, but its data-fetching endpoint is failing.
3. The card conditions object type, record type, or filters are not satisfied.
4. The account does not have access to the CRM object the card is attached to.
If all these points are covered correctly, then please contact HubSpot support, they can guide you best.
I hope this will help you out. Please mark it as Solution Accepted and upvote to help another Community member.
Thanks!
Thank you for your response. I have checked the scopes, and it all seems fine to me. As @RubenBurdin also mentioned, it looks like a connection issue.
Hey Athul
Looking at your screenshot, the issue is pretty clear. Your deployed app is still trying to reach localhost:8080 (the local dev server) which obviously wont exist in production. The key errors are:
GET localhost:8080/servers/ui-extensions-dev-server net::ERR_CONNECTION_REFUSED and Local network access permission is not enabled. This is required to connect to the UI Extensions Dev Server.
This usually means one of two things:
The deployment didnt fully complete or publish the production version of your extension. After running hs project upload, make sure you also run hs project deploy to actually deploy the build. The upload just stages it, deploy makes it live.
The app installation in the target HubSpot account might still be linked to your development version rather than the deployed production build. In your developer account, go to your app settings and check which version is actually installed in the target portal. You may need to reinstall the app or update the installation to point to the production build.
Also worth checking your hubspot.config.yml to make sure your production account ID is correctly configured and that you deployed to the right environment.
GRajput’s points about OAuth scopes and card conditions are also valid, but based on the specific errors in your screenshot, the localhost connection issue is the root cause here. The card is literally trying to load from your local machine instead of HubSpot’s servers.
At Stacksync we’ve built a few HubSpot app cards and this deployment gotcha tripped us up early on too. The dev/deploy distinction isnt super obvious in the docs. Note: The content is based on my personal experience and was refined using AI for better clarity.
Hope that helps!
Thanks for the response. The auto-deploy feature is enabled, so after running the hs project upload command, my understanding is that there is no need to manually deploy the build again. I did attempt a manual deploy as well, but it indicated that the latest build was already deployed.
I have also tried uninstalling and reinstalling the app multiple times, but the issue still persists.
You mentioned checking the hubspot.config.yml file to ensure the production account ID is correctly configured and that the deployment was done to the correct environment. Could you please elaborate on this? I am using the latest HubSpot platform version (2025.2), and I do not see a hubspot.config.yml file in my project.
Below are the steps I followed. Please let me know if I have missed anything or done something incorrectly:
During my research, I noticed that in some examples, the hs project upload command is run with the --account flag. Is this flag required in this case?
Kindly let me know if there are any mistakes in the above steps or additional checks I should perform.
Hey @Athul_C - thanks so much for following up here!
I’d like to re-tag @GRajput and @RubenBurdin to see what context they may have in response to your follow-up questions!
Shane, Senior Community Moderator
Hi @RubenBurdin, could you please get back to me on this?
