Secure Authentication
We use secure OAuth 2.0 authentication to connect without sharing your login details.
Required Scopes for CRM Integrations
When connecting Alta to your CRM, you’ll need to grant specific OAuth scopes during authentication.
Why these scopes are needed?
These permissions ensure Alta can:
Read existing CRM records (to avoid duplicates)
Write new records (contacts, companies, deals) from campaigns
Sync activity logs (emails, calls, meetings)
Stay connected without requiring you to re-authenticate
HubSpot Required Scopes
oauth
→ Core authenticationcrm.lists.read
→ View listscrm.lists.write
→ Create and update listscrm.objects.companies.read
→ View company recordscrm.objects.companies.write
→ Create and update company recordscrm.objects.contacts.read
→ View contact recordscrm.objects.contacts.write
→ Create and update contact recordscrm.objects.deals.read
→ View deals/opportunitiescrm.objects.deals.write
→ Create and update deals/opportunitiescrm.objects.owners.read
→ View CRM owners (reps)crm.schemas.companies.read
→ View company schema (field definitions)crm.schemas.companies.write
→ Modify company schemacrm.schemas.contacts.read
→ View contact schemacrm.schemas.contacts.write
→ Modify contact schemacrm.schemas.deals.read
→ View deal schemacrm.schemas.deals.write
→ Modify deal schema
Salesforce Required Scopes
openid
→ Authenticate users securelyrefresh_token
→ Keep the integration connected without re-loginapi
→ Access Salesforce data (contacts, accounts, opportunities, etc.)
Pipedrive Authentication
You can connect Pipedrive to Alta either with OAuth (recommended) or with an API token.
Using OAuth (Recommended)
In Alta, click Connect with Pipedrive.
Sign in to your Pipedrive account.
Authorize the requested scopes.
Using an API Token
In Pipedrive, go to Profile → Personal preferences → API.
Copy your API token.
In Alta, paste the token into the API Key field and click Connect.