# Hubspot

## Introduction

This document provides an overview of the integration between Automate and HubSpot, offering users the ability to automate various operations within the HubSpot application. By utilizing the pre-built actions in Automate, users can streamline their online marketing efforts, enhance customer relationships, and optimize sales processes.

## What is HubSpot?

HubSpot is a comprehensive platform designed to assist businesses in managing their online marketing strategies, strengthening customer relationships, and ultimately increasing sales. It offers a range of tools and functionalities to streamline marketing efforts, manage customer interactions, and track sales leads.

#### Key Features of HubSpot:

* <mark style="color:orange;">**Marketing Automation:**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">Create and manage marketing campaigns, track customer interactions, and analyze campaign performance.</mark>
* <mark style="color:orange;">**CRM (Customer Relationship Management):**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">Organize and manage customer data, track interactions, and improve customer engagement.</mark>
* <mark style="color:orange;">**Sales Automation:**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">Streamline sales processes, track leads, and manage sales pipelines effectively.</mark>

## Automate Integration with Hubspot

The Automate integration with HubSpot enables you to automate a variety of tasks and operations within the HubSpot application. Whether it's creating new records, updating existing data, or retrieving information, these pre-built actions make it easier to manage your HubSpot activities efficiently.

#### Examples of Automated Tasks:

* Archive Record: Store historical data by archiving records based on specified criteria.
* Create Quota: Generate new quotes with customizable details such as name and expiration date.
* Create Record: Quickly create new records for entities such as companies, contacts, deals, and more.
* Create Ticket: Generate new support tickets directly from your workflows.
* Get Record By ID: Retrieve detailed information about a specific record using its unique ID.
* List Deal Stages: Retrieve a list of deal stages within a specified sales pipeline.
* List Record: Generate a list of records based on specific criteria for better organization.
* Search Object: Efficiently search for objects (e.g., companies, contacts) based on custom criteria.
* Update Record: Modify existing records with new information to keep data up to date.

## Using the Integration

To begin using the integration, users will need to define their credentials and configure the necessary inputs for each action. The following sections provide detailed instructions on how to use each action within the Automate-HubSpot integration.

### Credentials

To establish a secure connection between Automate and HubSpot, follow these steps:

1. Select your credentials that you created at [Vault](https://docs.autommate.com/userguide/product-features/management/vault).
2. Proceed to the Data Manager screen to select the desired object.
3. Available objects include:
   * Company
   * Contact
   * Deal
   * Line Item
   * Products
   * Quotes
   * Tickets
4. Select the Object ID associated with your chosen object.

### Data Management

Manage the input parameters for each action using the Data Manager:

1. Object: Selected during the Data Manager object selection.
2. Object ID: Automatically populated based on the selected object.

## How To Use Actions

{% embed url="<https://drive.google.com/file/d/133gBc-mW7eTY59xUgebtKpGESkHfNTdY/view?usp=sharing>" %}

### Archive Record

<figure><img src="https://4222414448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMAf5diEa8kgXDA6h47Cu%2Fuploads%2FROMYHxSW8Qt5hADfYVuR%2Fimage.png?alt=media&#x26;token=45c8f471-778d-45e6-b13c-f91437ed6ef4" alt=""><figcaption></figcaption></figure>

**Description:** Archives a record to maintain a clean database while preserving historical data.

**Purpose:** This action allows you to archive specific entities within your system.

**Usage:**

* Select the appropriate credentials for authentication.
* Choose the entity type (Object) you wish to archive.
* The Object ID will be automatically populated based on the selected object.
* Execute the action to archive the record.

**Input Parameters:**

* Object: <mark style="color:green;">Select the entity type to archive (e.g., Company, Contact).</mark>
* Object ID: <mark style="color:green;">Automatically populated based on the selected object.</mark>

**Output:**

* Detailed information about the archived record.

***

### Create Quote

<figure><img src="https://4222414448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMAf5diEa8kgXDA6h47Cu%2Fuploads%2FgOHFqAuVuEUbfuLP2tsF%2Fimage.png?alt=media&#x26;token=1055ff9b-c4b0-4945-b2d5-4de7f17b6b02" alt=""><figcaption></figcaption></figure>

**Description:** Generates a new quote effortlessly.

**Purpose:** This action simplifies the process of creating new quotes.

**Usage:**

* Select the relevant credentials for authentication.
* Provide a name for the new quote (Quote Name).
* Specify the expiration date of the quote (Expiration Date).
* Execute the action to create the new quote.

**Input Parameters:**

* Quote Name: <mark style="color:green;">Name for the new quote.</mark>
* Expiration Date: <mark style="color:green;">Date when the quote expires (e.g., 2023-12-24T01:01:12.123Z).</mark>

**Output:**

* Details of the newly created quota.

***

### Create Record

<figure><img src="https://4222414448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMAf5diEa8kgXDA6h47Cu%2Fuploads%2FOkEDunAtTAknpKA1zhOV%2Fimage.png?alt=media&#x26;token=3b4cf630-3940-4fc0-bfba-9ea14f2f2e12" alt=""><figcaption></figcaption></figure>

**Description:** Easily creates new records for various entities in HubSpot.

**Purpose:** This action streamlines the process of creating new records.

**Usage:**

* Select the appropriate credentials for authentication.
* Choose the type of object to create (Object Selection).
* Provide the required input parameters for the selected object.
* Execute the action to create the new record.

**Input Parameters:**

* <mark style="color:green;">The Data Manager screen will display available input parameters for the selected object.</mark>

{% embed url="<https://drive.google.com/file/d/1TcXOjW96mo0AIbH48v5-yb-6b521i_hD/view?usp=sharing>" %}

**Output:**

* Information about the newly created record upon successful execution.

***

### Create Ticket

<figure><img src="https://4222414448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMAf5diEa8kgXDA6h47Cu%2Fuploads%2F7lYgyGbY6d2qV7jF8GI3%2Fimage.png?alt=media&#x26;token=8953fade-98b5-4228-ab11-e5003ebc9458" alt=""><figcaption></figcaption></figure>

**Description:** Streamlines customer support processes by creating new tickets within HubSpot.

**Purpose:** This action facilitates the creation of new tickets for customer inquiries.

**Usage:**

* Drag and Drop the "Create Ticket" function to your workflow.
* Configure default inputs or additional inputs via the Data Manager if needed.
* Specify the Ticket Subject, Pipeline Stage ID, and Pipeline ID.
* Execute the action to create the new ticket.

**Input Parameters:**

* Ticket Subject: <mark style="color:green;">Subject or title of the ticket.</mark>
* Pipeline Stage ID: <mark style="color:green;">Stage of the ticket in your pipeline.</mark>
* Pipeline ID: <mark style="color:green;">ID of the relevant pipeline.</mark>

<figure><img src="https://4222414448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMAf5diEa8kgXDA6h47Cu%2Fuploads%2FXlJO7wNpUDZJ4F2fXsg0%2Fimage.png?alt=media&#x26;token=78cf2f3a-7664-4557-919a-88f089010c47" alt=""><figcaption><p>You can use more input select from Data Manager</p></figcaption></figure>

**Output:**

* This action creates a new ticket within HubSpot without specific output.

***

### Get Record By ID

<figure><img src="https://4222414448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMAf5diEa8kgXDA6h47Cu%2Fuploads%2FxGrzaALBRzJbXiuygB1F%2Fimage.png?alt=media&#x26;token=94bb90d8-253e-465a-9c2e-5f3c0f389b5e" alt=""><figcaption></figcaption></figure>

**Description:** Retrieves detailed information about a specific record using its unique ID.

**Purpose:** This action fetches comprehensive details of a record based on its identifier.

**Usage:**

* Specify the type of object to retrieve (Object).
* Provide the unique identifier of the record (Object ID).
* Optionally, specify custom properties to display (Properties).
* Execute the action to retrieve the record.

**Input Parameters:**

* Object: <mark style="color:green;">Type of object to retrieve.</mark>
* Object ID: <mark style="color:green;">Unique identifier of the record.</mark>
* Properties: <mark style="color:green;">Optionally, custom properties to display.</mark>

**Output:**

* Comprehensive information about the requested record.

***

### List Deal Stages

<figure><img src="https://4222414448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMAf5diEa8kgXDA6h47Cu%2Fuploads%2FVAZbp0coxAGV3G3PGRLI%2Fimage.png?alt=media&#x26;token=fe80fbff-af99-46d9-b2c7-f22dbf4811ef" alt=""><figcaption></figcaption></figure>

**Description:** Retrieves a list of deal stages within a specified sales pipeline.

**Purpose:** This action provides a list of deal stages associated with a particular pipeline.

**Usage:**

* Provide the Pipeline ID of the sales pipeline.
* Execute the action to retrieve the list of deal stages.

**Input Parameters:**

* Pipeline ID: <mark style="color:green;">Identify the sales pipeline.</mark>

**Output:**

* List of deal stages associated with the specified pipeline.

***

### List Record

<figure><img src="https://4222414448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMAf5diEa8kgXDA6h47Cu%2Fuploads%2FdH6cCKreTnYuhV33iXCT%2Fimage.png?alt=media&#x26;token=8382ba1f-f81a-4dac-9068-c2e197f06d42" alt=""><figcaption></figcaption></figure>

**Description:** Generates a list of records based on specific criteria.

**Purpose:** This action efficiently filters records based on user-defined criteria.

**Usage:**

* Choose the type of object (Object) such as Company, Contact, Deal, Line Item, Products, Quotes, or Tickets.
* Specify the maximum number of results per page (Limit).
* Filter records based on archived status (Is Archived?).
* Optionally, specify custom properties to display (Properties).
* Execute the action to generate the list of records.

**Input Parameters:**

* Object: <mark style="color:green;">Type of object to list.</mark>
* Limit: <mark style="color:green;">Maximum number of results per page.</mark>
* Is Archived?: <mark style="color:green;">Filter based on archive status (Yes or No).</mark>
* Properties: <mark style="color:green;">Optionally, custom properties to display.</mark>

**Output:**

* Comprehensive list of records based on the specified criteria.

***

### Search Object

<figure><img src="https://4222414448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMAf5diEa8kgXDA6h47Cu%2Fuploads%2FzNiAGB2zx4cikFMuYDGP%2Fimage.png?alt=media&#x26;token=e89957bc-7902-4715-a208-fb51f155bc57" alt=""><figcaption></figcaption></figure>

**Description:** Efficiently searches for objects based on custom criteria.

**Purpose:** This action allows users to search for specific objects based on defined search criteria.

**Usage:**

* Choose the type of object (Object) such as Company, Contact, Deal, Line Item, or Products.
* Specify the property field to search (Property).
* Select a search operator to refine the search (Search Operator).
* Provide the value to search for (Search Value).
* Specify the maximum number of objects per page (Limit).
* Execute the action to perform the search.

**Input Parameters:**

* Object: <mark style="color:green;">Type of object to search.</mark>
* Property: <mark style="color:green;">Property field to search.</mark>
* Search Operator: <mark style="color:green;">Operator to refine the search.</mark>
* Search Value: <mark style="color:green;">Value to search for.</mark>
* Limit: <mark style="color:green;">Maximum number of objects per page.</mark>

**Output:**

* Search results based on the specified criteria.

***

### Update Record

<figure><img src="https://4222414448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMAf5diEa8kgXDA6h47Cu%2Fuploads%2FSsrqGcN8msDBi2goraBc%2Fimage.png?alt=media&#x26;token=d5cfe869-dd13-438c-89ce-24f4c27a2c90" alt=""><figcaption></figcaption></figure>

**Description:** Updates existing records with new information.

**Purpose:** This action enables users to keep their data up-to-date by modifying existing records.

**Usage:**

* Specify the type of object to update (Object).
* Provide the unique identifier of the record to update (Object ID).
* Execute the action to update the record.

**Input Parameters:**

* Object: <mark style="color:green;">Type of object to update.</mark>
* Object ID: <mark style="color:green;">Unique identifier of the record.</mark>

**Output:**

* This action updates the specified record in HubSpot without specific output.

***

## Additional Tips

### [**Use Cases**](https://docs.autommate.com/userguide/use-cases)

### [FAQ](https://docs.autommate.com/userguide/faq)
