Skip to main content

FAQ: CRM Integration Permissions

To connect Alta to your CRM securely and accurately, certain permissions are required. Here are common questions about them.

Sharon Drelevich avatar
Written by Sharon Drelevich
Updated over a week ago

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 authentication

  • crm.lists.read → View lists

  • crm.lists.write → Create and update lists

  • crm.objects.companies.read → View company records

  • crm.objects.companies.write → Create and update company records

  • crm.objects.contacts.read → View contact records

  • crm.objects.contacts.write → Create and update contact records

  • crm.objects.deals.read → View deals/opportunities

  • crm.objects.deals.write → Create and update deals/opportunities

  • crm.objects.owners.read → View CRM owners (reps)

  • crm.schemas.companies.read → View company schema (field definitions)

  • crm.schemas.companies.write → Modify company schema

  • crm.schemas.contacts.read → View contact schema

  • crm.schemas.contacts.write → Modify contact schema

  • crm.schemas.deals.read → View deal schema

  • crm.schemas.deals.write → Modify deal schema


Salesforce Required Scopes

  • openid → Authenticate users securely

  • refresh_token → Keep the integration connected without re-login

  • api → 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)

  1. In Alta, click Connect with Pipedrive.

  2. Sign in to your Pipedrive account.

  3. Authorize the requested scopes.

Using an API Token

  1. In Pipedrive, go to Profile → Personal preferences → API.

  2. Copy your API token.

  3. In Alta, paste the token into the API Key field and click Connect.

Did this answer your question?