HubSpot credentials

You can use these credentials to authenticate the following nodes:

• HubSpot
• HubSpot Trigger

Prerequisites

Create a HubSpot account or HubSpot developer account.

Supported authentication methods

• App token: Used with HubSpot node
• Developer API key: Used with HubSpot Trigger node
• OAuth2: Used with HubSpot node

Related resources

The HubSpot Trigger node uses the Webhooks API; refer to HubSpot's Webhooks API documentation for more information about that service.

Using App token

To configure this credential, you'll need:

• An APP Token : To generate an app token, create a private app in HubSpot. Refer to the HubSpot Private Apps documentation for detailed instructions.

Authenticating the credential can fail if you don't use appropriate scopes. See Required scopes for HubSpot node for required scopes for this app.

Using Developer API key

To configure this credential, you'll need:

• A Client ID : Generated once you create a public app, displayed in the app's Auth settings. Refer to the instructions in the HubSpot Public Apps documentation .
  • Use the Mosaic Workflows OAuth Redirect URL as the Redirect URL in your HubSpot app.
• A Client Secret : Generated once you create a public app, displayed in the app's Auth settings.
• A Developer API Key : Generated from your Developer Applications dashboard. Refer to HubSpot Developer API keys for more information.
• An App ID : Generated once you create a public app, displayed in the app's Auth settings.

Authenticating the credential can fail if you don't use appropriate scopes. See Required scopes for HubSpot Trigger node for required scopes for this app.

Required scopes for HubSpot Trigger node

If you're creating an app for use with the HubSpot Trigger node, Mosaic Workflows recommends starting with these scopes:

• oauth
• crm.objects.companies.read
• crm.objects.contacts.read
• crm.objects.deals.read
• crm.schemas.companies.read
• crm.schemas.contacts.read
• crm.schemas.deals.read

Using OAuth2

If you need to configure OAuth2 from scratch, you'll need to create a public app. Refer to the instructions in the HubSpot Public Apps documentation. If you need more detail on what's happening in the OAuth web flow, refer to the HubSpot Working with OAuth documentation.

Authenticating the credential can fail if you don't use appropriate scopes. See Required scopes for HubSpot node for required scopes for this app.

Required scopes for HubSpot node

If you're creating an app for use with the HubSpot node, Mosaic Workflows recommends starting with these scopes:

• oauth
• crm.objects.contacts.read
• crm.objects.contacts.write
• crm.objects.companies.read
• crm.objects.companies.read 1
• crm.objects.deals.read
• crm.objects.companies.read 3
• crm.objects.companies.read 4
• crm.schemas.companies.read
• crm.schemas.contacts.read
• crm.schemas.deals.read
• crm.objects.companies.read 8
• crm.objects.companies.read 9