Skip to main content

HubSpot

Overview

Category: crm, marketing_automation

Supaglue uses the HubSpot V3 API.

FeatureAvailable
Authentication (oauth2)Yes
Managed syncsYes
    Sync strategies(listed below)
Unified APIYes
    Data invalidationYes
Real-time eventsNo
Passthrough APIYes

Supported CRM common objects:

ObjectSoft delete supportedSync strategy
CompanyYesIncremental
ContactYesIncremental
DealYesIncremental
UserYesIncremental (in-memory)
info

Note: Supaglue does not sync association changes until the relevant object gets modified in the remote provider.

Supported CRM standard objects:

ObjectSoft delete supportedSync strategy
companyYesIncremental
contactYesIncremental
dealYesIncremental
line_itemYesIncremental
productYesIncremental
ticketYesIncremental
quoteYesIncremental
callYesIncremental
communicationYesIncremental
emailYesIncremental
meetingYesIncremental
noteYesIncremental
postal_mailYesIncremental
taskYesIncremental

Supported CRM custom objects:

Use the internal names when configuring the SyncConfig. See HubSpot's documentation for more information. If you created the custom object through Supaglue's API, the internal name is equivalent to the name field.

Syncs are Full or Incremental, and soft deletes are supported.

Supported Marketing Automation common objects:

  • Forms

Provider setup

To connect to your customers' HubSpot instances, you'll need to update the redirect URL to point to Supaglue and fetch the API access credentials in your HubSpot developer account.

Add Redirect URL to your HubSpot app

Supaglue provides a redirect URL to send information to your app. To add the redirect URL to your HubSpot app:

  1. Log in to your HubSpot developer account (https://developers.hubspot.com)

  2. Navigate to your Public Application under "Apps" and go to the "Auth" tab.

    app.hubspot.com/developer/12345678/application/123456

    hubspot_connected_app_oauth

  3. Under "Redirect URLs", paste Supaglue's redirect URL:

    https://api.supaglue.io/oauth/callback

Generate scopes

  1. Check the permissions below that your application needs, to generate the HubSpot scopes you will request from your customer.

    ScopeReadWrite
    crm.objects.owners
    crm.objects.companies
    crm.lists
    crm.objects.deals
    crm.objects.contacts
    crm.objects.quotes
    crm.objects.line_items
    crm.objects.custom
    crm.schemas.custom
    crm.schemas.companies
    crm.schemas.contacts
    crm.schemas.deals
    crm.schemas.line_items
    crm.schemas.quotes
    Scope
    forms
    Scope
    timeline
    tickets
  2. Click Save to update your changes.

info

Creating custom objects via the HubSpot API is restricted to OAuth apps that are part of HubSpot's pilot program. If you have this use case, you'll need to request access to this scope.

Fetch HubSpot Public App credentials

  1. Copy the Client ID, Client secret, and scopes (comma-separated), and paste them into the HubSpot configuration form in the management portal.