APIs & Integrations

CommifyJonathan
Member

Sample App Checklist is missing Redirect URL oauth-callback instruction

Hi all,
I'm new to HubSpot app development & so was following the sample app checklist that makes use of the Node.js app available at git https://github.com/HubSpot/oauth-quickstart-nodejs.git
In terms of configuring your app, the only thing it says is to 'Configure app permissions' to add the 'contacts' scope.
As far as I can see, it fails to mention that the Redirect URL needs setting at all. I initially tried setting it to http://localhost:3000 which the Node app starts up on. That, of course, just brings you back to the index page offering you to Install the App and no sign of an Access Token at all.

After reviewing the index.js file, I spotted the mention of an 'oauth-callback' endpoint that the app was listening to. Changing the Redirect URL to http://localhost:3000/oauth-callback did then allow the sample app to complete Steps 3 & 4 and retrieve a test contact.

Unless I'm missing something, this instruction is missing from the checklist and confusing to new starters. Does this need amending and how can I raise this so that HubSpot improve this documentation to help other new starters please?


Screenshot 2020-06-01 at 17.22.04.png

0 Upvotes
3 Replies 3
WendyGoh
HubSpot Employee
HubSpot Employee

Sample App Checklist is missing Redirect URL oauth-callback instruction

Hey @CommifyJonathan,

 

Thanks for sharing this piece of feedback!

 

Do you mind sharing with me how do you get to the sample app checklist that you referenced on your screenshot? Is there a link? 

0 Upvotes
CommifyJonathan
Member

Sample App Checklist is missing Redirect URL oauth-callback instruction

Hi Wendy,

The 'Getting Started' checklist was presented to me at the top of the navigation when viewing my App.

https://app.hubspot.com/developer/{DevID}/application/{AppID}/sample-app-checklist
Screenshot 2020-06-03 at 11.16.50.png

 

Hope this helps,

Cheers,

Jonathan

0 Upvotes
WendyGoh
HubSpot Employee
HubSpot Employee

Sample App Checklist is missing Redirect URL oauth-callback instruction

Hey @CommifyJonathan,

 

Thanks for sharing the screenshot and link! 

 

I'll pass along this feedback to the internal team and I'd also like to suggest your team to check out this documentation: OAuth 2 Quickstart Guide in which the steps to set up OAuth were being detailed down clearly. 

0 Upvotes