You'll need to provide:
- HubSpot client secret (from your HubSpot developer account)
- HubSpot access token (API key)
- HubSpot account ID (found under your account name in the HubSpot dropdown menu in the top right corner)
1: Access private apps settings
- Log into your regular HubSpot account (not the developer account)
- Click the settings gear icon in the top navigation bar
- In the left sidebar, navigate to "Integrations" > "Private Apps"
2: Create a private app for Pilea
- Click "Create a private app"
- On the "Basic Info" tab:
- App name: Enter "Pilea Integration" (or similar)
- Description: Enter "Private app for Pilea integration to sync feedback and product data"
3: Configure required scopes
- Click on the "Scopes" tab
- Add the following scopes:
tickets
- Access to HubSpot Service Hub ticketssales-email-read
- Read sales email datacrm.objects.companies.read
- Read company informationcrm.objects.contacts.read
- Read contact information
Search for each scope by name and check the box next to it
Note: Only select the scopes that Pilea actually needs to function. Contact Pilea support if you're unsure which scopes are required for your specific use case.
4: Create app and get your access token
- Click "Create app"
- Review the information in the modal and click "Continue creating"
- Once created, you'll see the app details page
- In the "Access token" section, click "Show token"
- Copy this entire token - this is your HubSpot access token
- Save it securely - you'll need to enter this in Pilea
Security Note: This access token provides access to your HubSpot data. Keep it secure and only share it through Pilea's secure connection form.
Finding your HubSpot Account ID
Your Account ID (also called Hub ID) is required for the Pilea integration:
Method 1: From the Account Dropdown
- In your HubSpot account, click on your account/company name in the top-right corner (next to your profile picture)
- Your Hub ID will be displayed in the dropdown menu
- Copy this number - this is your HubSpot account ID
Method 2: From the URL
- Look at your browser's address bar while in HubSpot
- Find the number after
app.hubspot.com/
in the URL - Example:
https://app.hubspot.com/contacts/12345678/objects/...
- Your Hub ID is
12345678
β
β