LogoLogo
HOMEAPPSBLOGDEVELOPERSGET A DEMO
  • Overview
    • Data
    • Middle's infrastructure
    • ENTERPRISE installations
    • Security
  • Workflows
    • Enable/disable an account
    • Connect or edit an app connection
    • Sync
      • Stored records
      • Sync history
    • Create or copy a workflow
    • Edit an existing workflow
    • Workflow steps
    • Workflow parameters
    • Triggers
  • User access
  • Performance
  • Data deletion
  • App development
    • Authentication
    • Credential storage
    • Sync records
    • Actions
    • Code packages
    • Upload scripts
    • Testing your apps
    • Versions
    • Monitor
  • Getting app credentials
    • ABC Ignite
    • Amazon S3
    • Clover
    • Emma
    • Erply
    • Facebook
    • fitDEGREE
    • Gmail
    • Google Sheets
    • HighLevel
    • Hubspot
    • Keap Max
    • Klaviyo
    • Lightspeed R-Series
    • Lightspeed X-Series
    • Mailchimp
    • Mindbody
    • OpenAI
    • Paramount Acceptance
    • Pike13
    • Salesforce
    • Shopify
    • Slack
    • Square
    • Vend
    • Xn
  • Guides
    • API limits
    • Building an API for Middle
    • Development best practices
Powered by GitBook
On this page
  • Creating a developer app
  • Public App
  • Private app
  • Syncing contact custom properties
  • Selecting properties to sync

Was this helpful?

  1. Getting app credentials

Hubspot

Instructions on how to authenticate Hubspot

PreviousHighLevelNextMindbody

Last updated 1 month ago

Was this helpful?

Creating a developer app

To connect HubSpot with Middle, you'll need to create either a public or private app in HubSpot to facilitate the connection.

Public App

For detailed guidance on creating a public developer app, refer to HubSpot's . You can also follow the Middle-specific instructions provided below.

Create a Hubspot developer account

If you don't already have one, you will need to .

Create a new app

  1. In your developer account, navigate to Apps in the main navigation bar.

  2. In the upper right, click Create app.

  3. Fill in the App Info with an app name and description.

  4. Go to the Auth tab.

  5. Scroll down to Redirect URLs.

  6. Enter the following URL, replacing {ENTER YOUR INSTANCE NAME HERE} with your instance name: {ENTER YOUR INSTANCE NAME HERE}.middle.app/oauth-redirect-uri/.

  7. Scroll down to Scopes.

  8. Set oauth scope as required and the following scopes as conditional:

    • crm.import

    • crm.objects.contacts.read

    • crm.objects.contacts.write

    • crm.objects.deals.read

    • crm.objects.deals.write

    • crm.objects.custom.read

    • crm.objects.custom.write

    • crm.objects.marketing_events.read

    • crm.objects.appointments.read

    • crm.objects.appointments.write

    • crm.objects.users.read

    • automation

    • forms

    • e-commerce

    • tickets

    • crm.schemas.custom.read

    • crm.schemas.contacts.read

    • crm.schemas.contacts.write

    • crm.schemas.appointments.write

    • crm.schemas.appointments.read

  9. Click Create app.

Add app public credentials to Middle

You will need to retrieve the Client ID and Client Secret for your new app from the Auth.

{"client_id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"client_secret": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"redirect_url": "https://{ENTER YOUR INSTANCE NAME HERE}.middle.app/oauth-redirect-uri/"}

You should now be all set to authenticate Hubspot in your instance.

Private app

For more information on how to create a private app, refer to Hubspots directions. Otherwise, follow the instructions below.

  • In your HubSpot account, click the settings icon in the main navigation bar.

  • In the left sidebar menu, navigate to Integrations > Private Apps.

  • Click Create private app.

  • On the Basic Info tab, configure the details of your app:

    • Enter your app's name.

    • Hover over the placeholder logo and click the upload icon to upload a square image that will serve as the logo for your app.

    • Enter a description for your app.

  • Click the Scopes tab.

  • Check off the following scopes:

    • crm.import

    • crm.objects.contacts.read

    • crm.objects.contacts.write

    • crm.objects.deals.read

    • crm.objects.deals.write

    • crm.objects.custom.read

    • crm.objects.custom.write

    • crm.objects.marketing_events.read

    • crm.objects.appointments.read

    • crm.objects.appointments.write

    • crm.objects.users.read

    • automation

    • forms

    • e-commerce

    • tickets

    • crm.schemas.custom.read

    • crm.schemas.contacts.read

    • crm.schemas.contacts.write

    • crm.schemas.appointments.write

    • crm.schemas.appointments.read

  • Click Create app in the top right.

  • In the dialog box, review the info about your app's access token, then click Continue creating. Middle will need the client_secret.

  • Click to finish creating the app.

Add private app credentials to Middle

{"access_token": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"redirect_url": "https://{ENTER YOUR INSTANCE NAME HERE}.middle.app/oauth-redirect-uri/"}

Assuming that you don't want this app used by any other account within your Middle organization, you should toggle on Use allowed accounts? and then select the account you want to have access to these credentials. You'll then need to select this API Key entry on the Hubspot app connection's Edit app connection page in the account your are trying to connect. When using a private app you'll want to complete the OAuth flow in the app connection to establish an initial connection.

Syncing contact custom properties

Custom properties can be synced into HubSpot for Contacts. For flexibility, properties are synced as arrays of key/value pairs. There is one array for each data type: strings, numbers, dates, datetimes, and arrays of strings. You can use array manipulation tools to integrate these custom properties into your workflow.

Selecting properties to sync

On the app connection page, you'll need to enter the internal property name (found in the property manager) under Custom Fields For Contacts.

Add them to section of your instance's HubSpot app along with your redirect URL. These details need to be added in JSON format. Below is an example:

You will need to retrieve the client_secret for your private app and add it to the section of your instance's HubSpot app along with your redirect URL. These details need to be added in JSON format. Below is an example:

In your Hubspot connection's , you'll need to list which custom properties you'd like to sync. This is set up to help limit the size of your contact records.

developer documentation
create a Hubspot developer account
Keys
Keys
authentication
Enter your custom properties one per line
Viewing the internal name for a Hubspot property