Skip to main content

HubSpot

Overview​

HubSpot is an all-in-one inbound marketing, sales, and customer relationship management (CRM) platform. Connect with HubSpot to create custom workflows, automate marketing tasks, sync data across applications, and enhance your team's productivity in Superblocks.

Setting up HubSpot​

Create an access token

To begin using HubSpot, follow these steps:

  1. Log in to your HubSpot account
  2. Click the settings icon in the main navigation bar
  3. On the left sidebar click Integrations → Private Apps
  4. Click Create a private app and name your application
  5. Click the Scopes tab to configure the permissions based on the data you need to manage
  6. Once you're done click Create
  7. Copy the token to configure your integration's connection

Learn more about HubSpot API Authentication

Add integration

Once you have an access token, you're ready to set up your Superblocks integration.

  1. In the web app, navigate to the Integrations page
  2. Click on the HubSpot tile
  3. Name the integration
  4. Paste your credentials into the relevant fields
  5. Optionally, add more configurations to set credentials for different environments
  6. Click Create
tip

HubSpot connected Now you can use HubSpot in any Application, Workflow, or Scheduled Job.

Use HubSpot in APIs​

Once your HubSpot integration is created, you can start calling HubSpot actions in Superblocks APIs.

HubSpot actions are REST requests. To learn more about REST requests in Superblocks, see the Building REST requests guide.

Supported actions​

Get all custom action functions

Returns a list of all functions that are associated with the given custom workflow action.

Get all custom actions

Returns a list of all custom workflow actions.

Create new custom action

Creates a new custom workflow action.

Get a custom action

Returns a single custom workflow action with the specified ID.

Update a custom action

Updates a custom workflow action with new values for the specified fields.

Archive a custom action

Archives a single custom workflow action with the specified ID. Workflows that currently use this custom action will stop attempting to execute the action, and all future executions will be marked as a failure.

List companies

Read a page of companies. Control what is returned via the `properties` query param.

Create a company

Create a company with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard companies is provided.

Read a company

Read an Object identified by `{companyId}`. `{companyId}` refers to the internal object ID by default, or optionally any unique property value as specified by the `idProperty` query param. Control what is returned via the `properties` query param.

Update a company

Perform a partial update of an Object identified by `{companyId}`. `{companyId}` refers to the internal object ID by default, or optionally any unique property value as specified by the `idProperty` query param. Provided property values will be overwritten. Read-only and non-existent properties will be ignored. Properties values can be cleared by passing an empty string.

Archive a company

Move an Object identified by `{companyId}` to the recycling bin.

Merge two contacts with same type

Archive a batch of contacts by ID

List contacts

Read a page of contacts. Control what is returned via the `properties` query param.

Create a contact

Create a contact with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard contacts is provided.

Update a batch of contacts

Create a batch of contacts

Read a contact

Read an Object identified by `{contactId}`. `{contactId}` refers to the internal object ID. Control what is returned via the `properties` query param.

Update a contact

Perform a partial update of an Object identified by `{contactId}`. `{contactId}` refers to the internal object ID. Provided property values will be overwritten. Read-only and non-existent properties will be ignored. Properties values can be cleared by passing an empty string.

Archive a contact

Move an Object identified by `{contactId}` to the recycling bin.

GDPR Delete a contact

Permanently delete a contact and all associated content to follow GDPR. Use optional property 'idProperty' set to 'email' to identify contact by email address. If email address is not found, the email address will be added to a blocklist and prevent it from being used in the future.

Read a batch of contacts by internal ID, or unique property values

List deals

Read a page of deals. Control what is returned via the `properties` query param.

Create a deal

Create a deal with the given properties and return a copy of the object, including the ID. Documentation and examples for creating standard deals is provided.

Read a deal

Read an Object identified by `{dealId}`. `{dealId}` refers to the internal object ID by default, or optionally any unique property value as specified by the `idProperty` query param. Control what is returned via the `properties` query param.

Update a deal

Perform a partial update of an Object identified by `{dealId}`. `{dealId}` refers to the internal object ID by default, or optionally any unique property value as specified by the `idProperty` query param. Provided property values will be overwritten. Read-only and non-existent properties will be ignored. Properties values can be cleared by passing an empty string.

Archive a deal

Move an Object identified by `{dealId}` to the recycling bin.
and 12 more

Generic HTTP Request​

Every SaaS integration in Superblocks comes with a built in Generic HTTP Request Action. This is a powerful action you can use to call HubSpot API endpoints not in the Superblocks supported actions.

To use this action simply add the method, path, required query parameters, and body for the desired endpoint.

info

Learn more about REST requests in Superblocks in our Building REST requests guide.

Generic HTTP Requests use the authentication set up and base URL you've configured for your integration, making it an easy for your team to extend Superblocks Integrations to meet their needs.