Connection Process with OAuth 2.0
- OAuth 2.0 Authentication: The integration uses OAuth 2.0, ensuring secure and reliable connectivity between Orbb and Hubspot.
- Authorization: When connecting, you will be prompted to authorize Orbb to access your Hubspot data.
- Token Exchange: After authorization, OAuth tokens are exchanged, allowing Orbb to interact with your Hubspot data.
OAuth Scopes and Their Purposes
Orbb’s access to Hubspot is read-only apart from contacts. Of the scopes it requests, only two grant write access and both are scoped to contacts; everything else is read-only.oauth: Needed for OAuth authentication processes.crm.objects.contacts.write: Allows creating contacts and writing theIntailproperty values listed below.crm.schemas.contacts.write: Allows creating theIntailcontact properties themselves, so Orbb has somewhere to write. Scoped to contact properties — HubSpot treats creating a property as a separate permission from writing to one.crm.objects.contacts.read: Enables reading contact data.crm.objects.companies.read: Enables reading company data.crm.objects.deals.read: Access to deal information.crm.objects.owners.read: Permits reading owner details within CRM.crm.schemas.contacts.read: Read access to contact schemas.crm.schemas.companies.read: Read access to company schemas.crm.schemas.deals.read: Allows read access to deal schemas.crm.export: Allows the export of CRM data.crm.lists.read: Permits reading list data.
Scopes Orbb does not requestOrbb asks only for the scopes it actually uses. It does not request the
ability to write to your company records (
crm.objects.companies.write) or to
create or modify lists (crm.lists.write), and it does not request access
to your sales email content (sales-email-read), tickets, custom objects or
custom schemas, or bulk CRM import (crm.import).Connection Options
Orbb connects to Hubspot through a user connection:- User Connection:
- Connect using a Hubspot admin user.
- All operations will be executed on behalf of this user.
- Suitable for smaller organizations or testing environments.
Data Fetching and Field Creation in Hubspot
Orbb fetches data and interacts with Hubspot by following a specific process, which involves the creation of reports in Hubspot and assigning predefined segments in the Orbb app.Creating Reports in Hubspot and Integration with Orbb
-
Hubspot List Creation:
- Users must create a report within Hubspot and note down its ID.
-
Report Integration with Orbb:
- Use the Hubspot List ID to create a corresponding report in the Orbb app.
- Assign one of the predefined segments from Orbb’s list to this report.
Data Synchronization Process
- Automatic Fetching:
- Orbb starts fetching contacts from the Hubspot report into its system.
- The fetch is triggered automatically whenever new contacts meet the criteria of the created report.
Data Processing and Actions
- Updating Contact Fields:
- Orbb runs the fetched contacts through its system.
- It updates various fields in Hubspot based on the data processed.
Custom Hubspot Fields Created by Orbb
Important NoteOrbb strictly creates only the following specified fields in Hubspot. No other fields are altered or added to ensure the integrity and security of your Hubspot data.Field labels keep the historical
Intail prefix (Orbb’s former brand) so that existing CRM data and reports remain consistent.Custom Fields for Contacts
Custom Fields for Leads
Important NoteLeads is a term used by Orbb to refer to contacts in Hubspot.
It creates a Contact object with lifecycle stage as Lead in Hubspot.
These tables list all custom fields created by Orbb for HubSpot contacts and companies, providing detailed descriptions and additional information where applicable.
These custom fields enable Orbb to effectively sync and update relevant data in Hubspot, optimizing CRM efficiency and data accuracy.