Duaer

Integrations

Set up HubSpot credentials in Duaer

Store HubSpot connection details in Duaer for digital-organization nodes to use at runtime. Secrets are protected by the instance encryption key and are not written into node parameters.

Choose a HubSpot credential type

The Duaer HubSpot node usually uses one of two credentials. HubSpot has retired the old HubSpot API (API key) type.

  • HubSpot Service Key: create an access token in HubSpot with the CRM scopes you need and put it in Service Key. Best when you connect only your own HubSpot account.
  • HubSpot OAuth2 API: create an app in a HubSpot developer account, set its redirect URL to the Duaer OAuth Redirect URL, include the scopes Duaer requests (listed below), then put Client ID and Client Secret in the credential.

HubSpot Trigger uses the HubSpot Developer API type, which needs the developer account app ID and developer API key.

HubSpot API

In Duaer, choose HubSpot API when you create a credential, then fill in these fields:

  • API Key (secret)

Note from the dialog: On 30 November, 2022 Hubspot will remove API key support. You will have to connect to HubSpot using private app or Oauth2 auth method. More details (HubSpot.com) (https://developers.hubspot.com/changelog/upcoming-api-key-sunset)

When you save, Duaer tests the connection with these values.

Duaer nodes that use it: HubSpot.

HubSpot Service Key

In Duaer, choose HubSpot Service Key when you create a credential, then fill in these fields:

  • Service Key (secret)

When you save, Duaer tests the connection with these values.

Duaer nodes that use it: HubSpot.

HubSpot Developer API

In Duaer, choose HubSpot Developer API when you create a credential, then fill in these fields:

  • Client ID (required)
  • Client Secret (required, secret)
  • Developer API Key (required, secret)
  • APP ID (required)

Duaer uses the OAuth2 Authorization Code grant for this type.

In the provider’s app settings, register the OAuth Redirect URL that the Duaer credential dialog shows (https://<your-duaer-host>/rest/oauth2-credential/callback). Then click Connect my account in Duaer and approve access.

By default, Duaer requests these scopes: crm.objects.contacts.read crm.schemas.contacts.read crm.objects.companies.read crm.schemas.companies.read crm.objects.deals.read crm.schemas.deals.read conversations.read tickets.

Optional settings shared by every Duaer OAuth2 credential: Ignore SSL Issues (Insecure), Token Expired Status Code, Encrypted Tokens (JWE), JWKS URI. They are described under OAuth2 API.

Duaer nodes that use it: HubSpot Trigger.

HubSpot OAuth2 API

In Duaer, choose HubSpot OAuth2 API when you create a credential, then fill in these fields:

  • Client ID (required)
  • Client Secret (required, secret)

Duaer uses the OAuth2 Authorization Code grant for this type.

In the provider’s app settings, register the OAuth Redirect URL that the Duaer credential dialog shows (https://<your-duaer-host>/rest/oauth2-credential/callback). Then click Connect my account in Duaer and approve access.

By default, Duaer requests these scopes: crm.lists.write crm.objects.contacts.read crm.objects.contacts.write crm.objects.companies.read crm.objects.companies.write crm.objects.deals.read crm.objects.deals.write crm.objects.owners.read crm.schemas.companies.read crm.schemas.contacts.read crm.schemas.deals.read forms tickets.

Optional settings shared by every Duaer OAuth2 credential: Ignore SSL Issues (Insecure), Token Expired Status Code, Encrypted Tokens (JWE), JWKS URI. They are described under OAuth2 API.

Duaer nodes that use it: HubSpot.

Save the connection in Duaer

Open Credentials and create HubSpot. Fill in the key, OAuth, or server fields. After you save, digital-organization nodes reference this credential instead of putting the secret in a parameter.

Credential values are protected by the instance encryption key. If you change or lose that key, stored credentials cannot be decrypted. See the hosting notes on encryption keys. The matching node is under the related node.

Who can use this credential

Who can see or edit it follows projects and roles. Do not paste secrets into chat or variables. External vaults are covered under external secrets.

Questions

Do HubSpot secret values appear in Duaer node parameters?

No. In Duaer, HubSpot secrets stay in the credential. Nodes only reference the credential. Execution records should not show the plaintext secret either.

What usually stops a HubSpot credential from saving in Duaer?

Wrong fields, an OAuth callback that does not match the instance URL, or a role that cannot create credentials. Check the fields HubSpot expects, then confirm you can create credentials in that project.

In this section