How to Use

First head over to HubSpot and click into the settings page. 

Under integrations on the left hand menu you will see Private Apps. 

Give the app a name and description and then click the Scopes tab

For Scopes you need to enable the following:

CRM Scopes:

• crm.objects.contacts.read - Read contact information
• crm.objects.contacts.write - Create and update contacts
• crm.schemas.contacts.read - Read contact properties/fields

Lists Scopes:

• crm.lists.read - Fetch available lists
• crm.lists.write - Add contacts to lists

Workflows/Automation Scopes:

• automation - Read workflows and enroll contacts

Communication Preferences (if using subscriptions):

• communication_preferences.read - Read subscription types
• communication_preferences.write - Subscribe contacts to communications

Account Information:

• account-info.security.read - Validate API key/token

Optional but Recommended:

• crm.objects.owners.read - If you want to assign contact owners
• forms - If you plan to integrate with HubSpot forms later

These scopes will enable all the features in your plugin:

• Creating/updating contacts
• Adding contacts to lists
• Enrolling contacts in workflows
• Managing email subscriptions
• Validating the API connection

Once this is completed you can skip past webhooks and click create app. At this point you will be given an API key. Make a note of this as we need this over on the Breakdance form. 

Breakdance Form

Make sure you have the plugin installed.

On your Breakdance form open the Actions option and tick the Hubspot option to enable it.

You can now open the Action options, enter your API key here. You will now be able to see any lists you have created on Hubpsot. Map the fields of your form to the Hubspot fields and exit the action panel. Hit save on Breakdance and you are done!