{{ __('Configure your HubSpot app credentials once for the whole platform. Workspaces then connect their own HubSpot portal via OAuth — WaDesk pushes WhatsApp customers and orders into HubSpot as contacts and deals.') }}
{{ __('Follow these five steps on the HubSpot developer portal to issue the credentials you paste below. This only happens once for the whole platform — every workspace then connects its own HubSpot account via OAuth.') }}
Go to {{ __('developers.hubspot.com') }} and create a free developer (app) account. This is separate from your normal HubSpot CRM login.
In the developer account open {{ __('Apps → Create app') }}. Give it your platform name and logo (shown to merchants on the OAuth consent screen).
In the app's {{ __('Auth') }} tab, under {{ __('Redirect URLs') }}, paste this exactly. It must match what we send or OAuth fails with {{ __('redirect_uri mismatch') }}:
{{ __('Note:') }} non-localhost redirect URLs must be HTTPS in production. For local testing HubSpot allows {{ __('http://localhost') }} (the literal host localhost, not an IP).
Still in the {{ __('Auth') }} tab, add the scopes below under {{ __('Scopes') }}, then copy the {{ __('Client ID') }} and {{ __('Client secret') }} into the box below. The scope list in the app and the scopes you paste here must match.
Tick the {{ __('Enable HubSpot') }} switch in the credentials box and hit {{ __('Save changes') }}. Workspace owners can now connect their HubSpot account at /hubspot.