Add HubSpot as a social connection

Enable HubSpot as a social connection

1. In the Clerk Dashboard, navigate to the SSO connections⁠ page.
2. Select Add connection and select For all users.
3. In the Choose provider dropdown, select HubSpot.
4. Ensure that both Enable for sign-up and sign-in and Use custom credentials are toggled on.
5. Save the Redirect URI somewhere secure. Keep this modal and page open.

Create a HubSpot Developer project

1. Navigate to the HubSpot account selection page⁠ and select the developer account you want to use. You'll be redirected to the Developer home page.
2. Select Create app. You'll be redirected to the app's configuration settings.
3. In the App Info tab, complete the form. The Public app name is required.
4. Select the Auth tab.
5. In the Redirect URLs section, paste the Redirect URI value you saved from the Clerk Dashboard.
6. In the Scopes section, select Add new scope.
7. Enable the crm.objects.owners.read scope and select Update.
8. Select Create app. You'll be redirected back to the App Info tab.
9. Select the Auth tab.
10. Save the Client ID and Client Secret values somewhere secure.

Set the Client ID and Client Secret in the Clerk Dashboard

1. Navigate back to the Clerk Dashboard where the modal should still be open. Paste the Client ID and Client Secret values that you saved into the respective fields.
2. Select Add connection.

Test your connection

The simplest way to test your connection is to visit your Clerk app's Account Portal, which is available for all Clerk apps out-of-the-box.

1. In the Clerk Dashboard, navigate to the Account Portal⁠ page.
2. Next to the Sign-in URL, select Visit. The URL should resemble:

• For development – https://your-domain.accounts.dev/sign-in
• For production – https://accounts.your-domain.com/sign-in

1. Sign in with your connection's credentials.