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://app.hubspot.com/developer

  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
  4. Check the following scopes under "Scopes":

    Required for CRM reads (common objects):

    • crm.objects.owners.read
    • crm.objects.companies.read
    • crm.lists.read
    • crm.objects.deals.read
    • crm.objects.contacts.read
    • crm.objects.custom.read (required for custom objects)
    • crm.schemas.custom.read (required for custom objects)

    Required for CRM writes (common objects):

    • crm.objects.contacts.write
    • crm.objects.companies.write
    • crm.objects.deals.write
    • crm.lists.write
    • crm.objects.custom.write
    • crm.schemas.custom.write

    Required for Forms:

    • forms
    info

    Supaglue requires a set of minimum scopes to support reads and writes to common object records.

  5. Click Save to update your changes.

Fetch HubSpot Public App credentials

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