Back to Settings

HubSpot Setup Guide

Connect your HubSpot account using a Private App access token.

1

Go to Private Apps

  1. Log into your HubSpot account
  2. Click the gear icon in the top navigation to open Settings
  3. In the left sidebar, navigate to Integrations → Private Apps
2

Create a Private App

  1. Click Create a private app
  2. Fill in the Basic Info tab:
    • Name: Let's Submit
    • Description: optional
  3. Go to the Scopes tab
  4. Search for and enable these scopes:
    • crm.objects.contacts.write — create contacts
    • crm.objects.contacts.read — read contacts
    • crm.objects.deals.write — create deals (optional)
  5. Click Create app in the top-right, then Continue creating

You need to be a Super Admin in HubSpot to create Private Apps. If you don't see the option, ask your HubSpot admin.

3

Copy the Access Token

After creating the app, HubSpot will show your Access Token. It starts with pat-na1- (or a similar prefix depending on your data center).

  1. Click Show token to reveal it
  2. Click Copy to copy it to your clipboard
  3. Paste it into the Private App Access Token field in Settings

Store this token securely. HubSpot will only show the full token once. If you lose it, you'll need to rotate the token from the Private App settings.

Quick Reference

Access Token Found on the Private App details page after creation
Required Scopes crm.objects.contacts.write, crm.objects.contacts.read
Permission Super Admin required to create Private Apps