HubSpot CRM

The HubSpot CRM modules enable you to monitor events, records, contacts, engagements, file and form submissions, or create, retrieve, update and delete records, contacts, engagements, events, or files in your HubSpot CRM account.

To get started with HubSpot CRM, you need:

Note

The module dialog fields that are displayed in bold (in the Make scenario, not in this documentation article) are mandatory.

Connect HubSpot CRM to Make Using your Account Credentials

To connect your HubSpot CRM account to Make:

  1. Log in to your Make account, and add a module from the HubSpot CRM app into a Make scenario.

  2. Click Add next to the Connection field.

    msedge_yeFNNZq8Fj.gif
  3. In the Connection field, enter a name for the connection and click Save.

  4. Confirm the dialog by clicking the Grant Access button.

    2019-11-26-11_23_44-window.png

You have successfully connected HubSpot CRM with the Make and can now build the scenarios.

Connect HubSpot CRM with Make using OAuth credentials

To connect HubSpot CRM with the Make with the OAuth credentials:

  1. Log in or create a HubSpot Developer account.

  2. Create a custom app and from the OAuth Settings screen, copy the Client ID and Client Secret values to a safe place. See Create a custom application.

  3. Retreive User ID and Hapi Key and copy them to a safe place. See Obtaining Hapi Key and User ID.

  4. Log in to your Make account, and add a module from the HubSpot CRM app into a Make scenario.

  5. Click Add next to the Connection field.

    msedge_yeFNNZq8Fj.gif
  6. Click Show advanced settings.

    msedge_0b6A52KxqG.png
  7. In the User ID and Hapi Key fields, enter the details you have copied in step 3.

  8. In the Client ID and Client Secret fields, enter the details copied in step 2 and click Save.

You have successfully connected HubSpot CRM with the Make and can now build the scenarios.

  1. Log in to your HubSpot developer account.

  2. Click Create an App option from the home page or Create app if you have already created apps.

    msedge_lZAHC41GmS.png
  3. In the App Info tab, enter the following details and click Save.

    msedge_zntCEPSFJp.png

    Public app name

    Enter (ma) the app name.

    App logo

    Click the Upload button to add an image for the image.

    Description

    Enter the app details.

  4. In the Auth tab, select the scopes you will need for your webhook. For example, add contacts scopes for triggering the module when a new contact is created or deleted.

    msedge_uP98HhbtMo.png

    Note

    The contacts scope is all you need to receive contacts, deals, and company event webhooks.

    Caution

    Do not fill the Redirect URL field.

  5. Click Save.

  6. Copy the Client ID and Client Secret values to a safe place.

    msedge_6q09tj1HZW.png
  1. Log in to your HubSpot developer account.

  2. Click Manage Apps.

    msedge_Np2jG9tVlw.png
  3. Click Get HubSpot API Key.

    msedge_ezH0UcFGly.png
  4. Copy the User ID to a safe place. Click Show key to display your HubSpot API Key.

    msedge_ouhVWc0nzZ.png

Watch Notifications

Triggers when a specified event in your HubSpot account occurs.

Before setting up your Watch Notifications module you need to:

Webhook Name

Enter the name of the module. For example, Contact created or updated.

Connection

Establish an OAuth connection to your HubSpot CRM account.

Application ID

Enter the App ID. It can be found in the app Auth settingsin your HubSpot developer account.

61d6a2fdb7481.png

Subscriptions

Add one or more HubSpot events that will trigger the Watch Notifications module. You can create a maximum of 1000 subscriptions per application (per one Watch Notifications module).

Force to remove old subscriptions

Deletes event subscriptions that were previously created in the app. If there are old subscriptions, these subscriptions must be deleted first and then a new webhook can be created.

You can also delete event subscriptions in your Webhooks app settings in your developer account.

61d6a2fecbe0e.gif

CRM Objects

You can watch, and search the CRM objects using the following modules.

Searches for CRM objects (contacts, companies, deals, products, tickets, line_items) by custom properties or by a query. To search for products or line_ites use a special connection with a required custom scope [e-commerce].

Required Permissions: crm.schemas.contacts.read, crm.schemas.companies.read, crm.schemas.deals.read, e-commerce, tickets, crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read

Connection

Establish a connection to your HubSpot CRM account.

Limit

Set the maximum number of CRM objects Make will return during one execution cycle.

Object Type to Search

Select or map the object type and fill the dynamic fields that appear based on your selection to search the objects.

Start Offset

Enter (map) the start offset [1..N] if you want to change the output result.

Triggers when a CRM object is created/updated. To watch products or line_items use a special connection with a required custom scope [e-commerce].

Required Permissions: crm.schemas.contacts.read, crm.schemas.companies.read, crm.schemas.deals.read, e-commerce, tickets, crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read

Connection

Establish a connection to your HubSpot CRM account.

Limit

Set the maximum number of CRM objects Make will return during one execution cycle.

Object Type to Search

Select or map the object type and fill the dynamic fields that appear based on your selection to watch the objects.

Records (Deals, Contacts, Companies)

You can watch, create, update, list, and delete the records using the following modules.

Creates a contact, a company, or a deal.

Required Permissions: crm.schemas.contacts.read, crm.schemas.companies.read, crm.schemas.deals.read, crm.objects.owners.read, crm.objects.contacts.write, crm.objects.companies.write, crm.objects.deals.write

Connection

Establish a connection to your HubSpot CRM account.

Property Groups

Select or map the property groups:

Contact

Select or map the property groups for the contact:

  • Contact information

  • Social media information

  • Email information

  • Web analytics history

  • Conversion information

Company

Select or map the property groups for the company:

  • Company activity

  • Company information

  • Social media information

  • Web analytics history

  • Conversion information

  • Target accounts information

Deals

Select or map the property groups for the deal:

  • Deal activity 

  • Deal information

  • Analytics history

Record Type

Select the record type:

  • Contact

  • Company

  • Deal

Contact

City

Enter the city name of the contact.

Close Date

Enter the date when the contact has become a customer. See the list of supported date and time formats.

Company Name

Enter the company name to which the contact belongs to.

Contact Owner

Select the owner who owns this contact.

Email

Enter the email address of the contact.

Fax Number

Enter the fax number of the contact.

First Name

Enter the first name of the contact.

Job Title

Enter the position of the contact.

Last Name

Enter the last name of the contact.

Lead Status

Select the status of the lead.

Legal basis for processing contact's data

Enter the legal basis for processing the contact's data.

Lifecycle Stage

Select the stage of the contact.

Marital Status

Enter the marital status of the contact.

Membership Notes

Enter the additional information about the contact membership.

Message

Enter the message for the contact.

Military status

Enter the military status as mentioned in the lead form.

Mobile Phone Number

Enter the mobile number of the contact.

Number of Employees

Enter the number of employees in the company.

Original Source

Select the source from which you got the lead to the contact.

Persona

Select the persona of the contact.

Phone Number

Enter the phone number of the contact.

Postal Code

Enter the postal code of the company.

Preferred language

Select the language for the contact.

Relationship Status

Select the status of the relationship.

Salutation

Enter the salutation of the Salutation for addressing the contact.

School

Enter the school details of the contact.

Status

Select the status of the contact relationship of the company.

State/Region

Enter the state name of the contact.

Street Address

Enter the street name.

Twitter Username

Enter the Twitter username of the contact.

Website URL

Enter the website URL address of the company.

Work email

Enter the working email address of the contact.

Company

About Us

Enter the details of the company.

Annual Revenue

Enter the annual revenue of the company.

City

Enter the city name.

Close Date

Enter the date on which the company becomes a member. See the list of supported date and time formats.

Company Domain Name

Enter the company's website domain name.

Company owner

Select the user assigned to the company.

Country/Region

Enter the country name where the company is located.

Description

Enter the details of the mission and goals of the company.

Facebook Company Page

Enter the website details of the company's Facebook page.

Facebook Fans

Enter the number of Facebook fans the company has.

Google Plus Page

Enter the website URL of the company's Google Plus page.

Industry

Select the industry in which the company operates.

Lead Status

Select the company sales prospecting status.

Lifecycle Stage

Select the life cycle stage of any contact associated with the contact.

LinkedIn Bio

Enter the details of the company's LinkedIn bio page.

LinkedIn Company Page

Enter the website URL of the company's LinkedIn page.

Name

Enter the company name.

Number of Employees

Enter the number of employees in the company.

Original Source Type

Select the source lead for the company.

Phone Number

Enter the phone number of the company.

Postal Code

Enter the postal code of the company.

State/Region

Enter the state name in which the company is located.

Street Address

Enter the street name where the company is located.

Street Address 2

Enter the street name where the company is located.

Time Zone

Enter the time zone in which the company is located.

Total Money Raised

Enter the amount of money the company has raised.

Twitter Bio

Enter the details of the company's Twitter bio.

Twitter Followers

Enter the number of Twitter followers the company has.

Twitter Handle

Enter the details of who handles the company's Twitter.

Type

Select your relationship with the company.

Web Technologies

Select the web technologies used by the company.

Website URL

Enter the company's website URL.

Year Founded

Enter the year in which the company is established.

Deal

Properties Edit Mode

Select the deal properties to edit the deal

Amount

Enter the deal amount.

Close Date

Enter the date the deal is expected to close or was closed. See the list of supported date and time formats.

Closed Lost Reason

Enter the reason for losing the deal.

Closed Won Reason

Enter the reason for winning the deal.

Create Date

Enter the reason for creating the deal. See the list of supported date and time formats.

Deal Description

Enter the detail of the deal.

Deal Name

Enter a name for the deal.

Deal owner

Enter the details of the user who owns the deal.

Deal Stage

Enter the stage at which the deal is in.

Deal Type

Enter the deal type.

Manual forecast category

Enter the forecast category of the deal.

Original Source Type

Enter the source type of the deal.

Pipeline

Enter the pipeline the deal is in which has the stages the deal is processed in.

Associated Contacts

Add the associated contacts of the deal.

Associated Companies

Add the companies associated with the deal.

Gets a contact, a company, or a deal.

Required Permissions: crm.schemas.contacts.read, crm.schemas.companies.read, crm.schemas.deals.read, crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read

Connection

Establish a connection to your HubSpot CRM account.

Record Type

Select the record type you want to retrieve:

  • Contact

  • Company

  • Deal

Search Type

Select the option to search the records you want to retrieve:

  • By ID

  • By Email

ID

Enter the Contact, Company, or Deal ID whose details you want to retrieve.

Email

Enter the email address whose details you want to retrieve.

Updates a contact, a company, or a deal.

Required Permissions: crm.schemas.contacts.read, crm.schemas.companies.read, crm.schemas.deals.read, crm.objects.owners.read crm.objects.contacts.write, crm.objects.companies.write, crm.objects.deals.write

Connection

Establish a connection to your HubSpot CRM account.

Record Type

Select the record type:

  • Contact

  • Company

  • Deal

Contact

Search Type

Select the option to search the records you want to retrieve:

  • By ID

  • By Email

ID

Enter the Contact, Company, or Deal ID whose details you want to update.

Email

Enter the email address of the contact whose details you want to update.

City

Enter the city name of the contact.

Close Date

Enter the date when the contact has become a customer. See the list of supported date and time formats.

Company Name

Enter the company name to which the contact belongs.

Contact Owner

Select the owner who owns this contact.

Email

Enter the email address of the contact.

Fax Number

Enter the fax number of the contact.

First Name

Enter the first name of the contact.

Job Title

Enter the position of the contact.

Last Name

Enter the last name of the contact.

Lead Status

Select the status of the lead.

Legal basis for processing contact's data

Enter the details of the legal basis for processing the data.

Lifecycle Stage

Select the stage of contact.

Marital Status

Enter the marital status of the contact.

Membership Notes

Enter the additional information about the contact membership.

Message

Enter the message for the contact.

Military status

Enter the military status as mentioned in the lead form.

Mobile Phone Number

Enter the mobile number of the contact.

Number of Employees

Enter the number of employees in the company.

Original Source

Select the source from which you got the lead to the contact.

Persona

Select the persona of the contact.

Phone Number

Enter the phone number of the contact.

Postal Code

Enter the postal code of the company.

Preferred language

Select the language for the contact.

Relationship Status

Select the status of the relationship.

Salutation

Enter the salutation for addressing the contact.

School

Enter the school details of the contact.

Status

Select the status of the contact relationship of the company.

State/Region

Enter the state name of the contact.

Street Address

Enter the street name.

Twitter Username

Enter the Twitter username of the contact.

Website URL

Enter the website URL address of the company.

Work email

Enter the working email address of the contact.

Company

ID

Enter the Company ID whose details you want to update.

About Us

Enter the details of the company.

Annual Revenue

Enter the annual revenue of the company.

City

Enter the city name.

Close Date

Enter the date on which the company becomes a member. See the list of supported date and time formats.

Company Domain Name

Enter the company's website domain name.

Company owner

Select the user assigned to the company.

Country/Region

Enter the country name where the company is located.

Description

Enter the details of the mission and goals of the company.

Facebook Company Page

Enter the website details of the company's Facebook page.

Facebook Fans

Enter the number of Facebook fans the company has.

Google Plus Page

Enter the website URL of the company's Google Plus page.

Industry

Select the industry in which the company operates.

Lead Status

Select the company sales prospecting status.

Lifecycle Stage

Select the life cycle stage of any contact associated with the contact.

LinkedIn Bio

Enter the details of the company's LinkedIn bio page.

LinkedIn Company Page

Enter the website URL of the company's LinkedIn page.

Name

Enter the company name.

Number of Employees

Enter the number of employees in the company.

Original Source Type

Select the source lead for the company.

Phone Number

Enter the phone number of the company.

Postal Code

Enter the postal code of the company.

State/Region

Enter the state name in which the company is located.

Street Address

Enter the street name where the company is located.

Street Address 2

Enter the street name where the company is located.

Time Zone

Enter the time zone in which the company is located.

Total Money Raised

Enter the amount of money the company has raised.

Twitter Bio

Enter the details of the company's Twitter bio.

Twitter Followers

Enter the number of Twitter followers the company has.

Twitter Handle

Enter the details of who handles the company's Twitter.

Type

Select your relationship with the company.

Web Technologies

Select the web technologies used by the company.

Website URL

Enter the company's website URL.

Year Founded

Enter the year in which the company is established.

Deal

ID

Enter the Deal ID whose details you want to update.

Properties Edit Mode

Select the deal properties to edit the deal

Amount

Enter the deal amount.

Close Date

Enter the date the deal is expected to close or was closed. See the list of supported date and time formats.

Closed Lost Reason

Enter the reason for losing the deal.

Closed Won Reason

Enter the reason for winning the deal.

Create Date

Enter the reason for creating the deal. See the list of supported date and time formats.

Deal Description

Enter the detail of the deal.

Deal Name

Enter a name for the deal.

Deal owner

Enter the user detail who owns the deal.

Deal Stage

Enter the stage at which the deal is in.

Deal Type

Enter the deal type.

Manual forecast category

Enter the forecast category of the deal.

Original Source Type

Enter the source type of the deal.

Pipeline

Enter the pipeline the deal is in which has the stages the deal is processed in.

Associated Contacts

Add the associated contacts of the deal.

Associated Companies

Add the companies associated with the deal.

Deletes a contact, a company, or a deal.

Required Permissions: crm.objects.contacts.write, crm.objects.companies.write, crm.objects.deals.write

Connection

Establish a connection to your HubSpot CRM account.

Record Type

Select the record type you want to retrieve:

  • Contact

  • Company

  • Deal

ID

Enter the Contact, Company, or Deal ID you want to delete.

Retrieves a list of contacts, companies, or deals. The output is limited to 5000 contacts, or 12500 companies, or 12500 deals.

Required Permissions: crm.schemas.contacts.read, crm.schemas.companies.read, crm.schemas.deals.read, crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read

Connection

Establish a connection to your HubSpot CRM account.

Type

Select the record type you want to list:

  • Contact

  • Company

  • Deal

Output Properties

Select the properties you want to list.

Limit

The maximum number of record properties Make should return during one scenario execution cycle.

Triggers when a contact, a company, or a deal has been recently modified or created within the last 30 days. The output is limited to 10K.

Required Permissions: crm.schemas.contacts.read, crm.schemas.companies.read, crm.schemas.deals.read, crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read

Connection

Establish a connection to your HubSpot CRM account.

Record Type

Select the record type you want to retrieve:

  • Contact

  • Company

  • Deal

Search Category

Select the category whose records you want to watch:

  • Recently modified

  • Recently created

Output Properties

Select the properties you want to watch.

Limit

The maximum number of records Make will return during one scenario execution cycle.

Contacts

Creates a contact if it doesn't exist in a portal already or updates it with the latest property values if it does.

Required Permissions: crm.schemas.contacts.read, crm.objects.contacts.write

Connection

Establish a connection to your HubSpot CRM account.

Annual Revenue

Enter the contact's company annual revenue.

City

Enter the contact's city name.

Close Date

Enter the date when the contact has become a member. See the list of supported date and time formats.

Company Name

Enter the contact's company name.

Company Size

Enter the number of employees in the company.

Contact Owner

Select the user who is associated with the contact.

Country/Region

Enter the country name where the contact is located.

Date of Birth

Enter the contact's date of birth. See the list of supported date and time formats.

Degree

Enter the details of the contact's degree qualifications.

Email

Enter the contact's email address.

Fax Number

Enter the contact's fax number.

First Name

Enter the contact's first name.

Gender

Enter the gender details of the contact.

Graduation Date

Enter the date when the contact has completed his graduation. See the list of supported date and time formats.

Job Title

Enter the position of the contact.

Last Name

Enter the contact's last name.

Lead Status

Select the status of the lead.

Legal basis for processing contact's data

Enter the details of the legal basis for processing the data.

Lifecycle Stage

Select the stage of contact.

Marital Status

Enter the marital status of the contact.

Membership Notes

Enter the additional information about the contact membership.

Message

Enter the message for the contact.

Military status

Enter the military status as mentioned in the lead form.

Mobile Phone Number

Enter the mobile number of the contact.

Number of Employees

Enter the number of employees in the company.

Original Source

Select the source from which you got the lead to the contact.

Persona

Select the persona of the contact.

Phone Number

Enter the phone number of the contact.

Postal Code

Enter the postal code of the company.

Preferred language

Select the language for the contact.

Relationship Status

Select the status of the relationship.

Salutation

Enter the details to address the contact.

School

Enter the school details of the contact.

Seniority

Enter the seniority level of the contact within the company.

Start Date

Enter the contact's start date with the company. See the list of supported date and time formats.

Status

Select the status of the contact relationship of the company:

State/Region

Enter the state of the contact's address.

Street Address

Enter the street name.

Twitter Username

Enter the contact's Twitter username.

Website URL

Enter the company's website URL.

Work email

Enter the contact's work email address.

Creates a contact if it doesn't exist in a portal already, or updates it with the latest property values if it does.

Required Permissions: crm.schemas.contacts.read, crm.objects.contacts.write, crm.objects.owners.read

Connection

Establish a connection to your HubSpot CRM account.

Property Groups

Select or map the property groups you want to update:

  • Contact information

  • Social media information

  • Email information

  • Web analytics history

  • Conversion information

Annual Revenue

Enter the contact's company annual revenue.

Buying Role

Select or map the buying role of the contact:

  • Blocker

  • Budget Holder

  • Champion

  • Decision Maker

  • End-User

  • Executive Sponsor

  • Influencer

  • Legal & Compliance

  • Other

City

Enter the contact's city name.

Close Date

Enter the date when the contact has become a member. See the list of supported date and time formats.

Company Name

Enter the contact's company name.

Company Size

Enter the number of employees in the company.

Contact Owner

Select the user who is associated with the contact.

Country/Region

Enter the country name where the contact is located.

Date of Birth

Enter the contact's date of birth. See the list of supported date and time formats.

Degree

Enter the details of the contact's degree qualifications.

Email

Enter the contact's email address.

Fax Number

Enter the contact's fax number.

First Name

Enter the contact's first name.

Gender

Enter the gender details of the contact.

Graduation Date

Enter the date when the contact has completed his graduation. See the list of supported date and time formats.

Job Title

Enter the position of the contact.

Last Name

Enter the contact's last name.

Lead Status

Select the status of the lead.

Legal basis for processing contact's data

Enter the details of the legal basis for processing the data.

Lifecycle Stage

Select the stage of contact.

Marital Status

Enter the marital status of the contact.

Membership Notes

Enter the additional information about the contact membership.

Message

Enter the message for the contact.

Military status

Enter the military status as mentioned in the lead form.

Mobile Phone Number

Enter the mobile number of the contact.

Number of Employees

Enter the number of employees in the company.

Original Source

Select the source from which you got the lead to the contact.

Persona

Select the persona of the contact.

Phone Number

Enter the phone number of the contact.

Postal Code

Enter the postal code of the company.

Preferred language

Select the language for the contact.

Relationship Status

Select the status of the relationship.

Salutation

Enter the details to address the contact.

School

Enter the school details of the contact.

Seniority

Enter the seniority level of the contact within the company.

Start Date

Enter the contact's start date with the company. See the list of supported date and time formats.

Status

Select the status of the contact relationship of the company:

State/Region

Enter the state name of the contact's address.

Street Address

Enter the street name.

Twitter Username

Enter the contact's Twitter username.

Website URL

Enter the company's website URL.

Work email

Enter the contact's work email address.

Creates a group of contacts or updates them if they already exist. Performs best when batch size is limited to 100 contacts or fewer. Changes made through this endpoint are processed asynchronously, so can take several minutes for changes to be applied to contact records.

Required Permissions: crm.schemas.contacts.read, crm.objects.contacts.write, crm.objects.owners.read

Connection

Establish a connection to your HubSpot CRM account.

Batch of Contacts to Create/Update

Add the batch of contacts:

Search Type

Select the option to search the records you want to retrieve:

  • By ID

  • By Email

ID

Enter the Contact ID.

City

Enter the city of the contact.

Close Date

Enter the date when the contact has become a customer. See the list of supported date and time formats.

Company Name

Enter the company name to which the contact belongs to.

Contact Owner

Select the owner who owns this contact.

Email

Enter the email address of the contact.

Fax Number

Enter the fax number of the contact.

First Name

Enter the first name of the contact.

Job Title

Enter the position of the contact.

Last Name

Enter the last name of the contact.

Lead Status

Select the status of the lead.

Legal basis for processing contact's data

Enter the legal basis for processing the contact's data.

Lifecycle Stage

Select the stage of contact.

Marital Status

Enter the marital status of the contact.

Membership Notes

Enter any additional information about the contact membership.

Message

Enter the message for the contact.

Military status

Enter the military status as mentioned in the lead form.

Mobile Phone Number

Enter the mobile number of the contact.

Number of Employees

Enter the number of employees in the company.;

Original Source

Select the source from which you got the lead to the contact.

Persona

Select the persona of the contact.

Phone Number

Enter the phone number of the contact.

Postal Code

Enter the Zip code of the company.

Preferred language

Select the language for the contact.

Relationship Status

Select the status of the relationship.

Salutation

Enter the salutation for addressing the contact.

School

Enter the school details of the contact.

Status

Select the status of the contact relationship of the company.

State/Region

Enter the state name of the contact.

Street Address

Enter the street name.

Twitter Username

Enter the Twitter username of the contact.

Website URL

Enter the website URL address of the company.

Work email

Enter the working email address of the contact.

Adds contact records that have already been created in the system to a contact list.

Required Permissions: crm.lists.read, crm.lists.write

Connection

Establish a connection to your HubSpot CRM account.

List ID

Select the List ID to which you want to add the contact.

IDs/Emails

Enter the Contact ID or Email address of the contact to add to the list.

Removes a contact from a contact list.

Required Permissions: crm.lists.read, crm.lists.write

Connection

Establish a connection to your HubSpot CRM account.

List ID

Select the List ID from which you want to remove the contact.

Contact ID

Enter the Contact ID you want to remove from the list.

Merges contacts.

Required Permissions: crm.objects.contacts.write

Connection

Establish a connection to your HubSpot CRM account.

ID 1

Enter the Contact ID you want to merge.

ID 2

Enter the Contact ID with which you want to merge the above-selected contact.

Retrieves a list of contacts using the search query.

Required Permissions: crm.schemas.contacts.read, crm.objects.contacts.write, crm.objects.owners.read

Connection

Establish a connection to your HubSpot CRM account.

Query

Enter the query for searching the contact.

Limit

The maximum number of contacts Make should return during one scenario execution cycle.

Returns all contacts that have been created in the portal. The output is limited to 5000 contacts. To list previous/next contacts, you can use the advanced parameter to reset an offset ID for listing contacts after this ID.

Connection

Establish a connection to your HubSpot CRM account.

Limit

The maximum number of contacts Make should return during one scenario execution cycle.

Output Properties

Select the properties for which you want to list the contacts.

Contact ID [start offset]

Enter the Contact ID you want to list.

Retrieves a list of contacts in the company. The output is limited to 5000 contacts. To list previous/next contacts, you can use the advanced parameter to reset an offset ID for listing contacts after this ID.

Required Permissions: crm.schemas.contacts.read, crm.objects.companies.read

Connection

Establish a connection to your HubSpot CRM account.

ID

Enter the Company ID whose contacts you want to list.

Limit

The maximum number of contacts Make should return during one scenario execution cycle.

Contact ID [start offset]

Enter the Contact ID of the company you want to list

Triggers when a new contact is added to a list (only for users with the paid Marketing account).

Required Permissions: crm.schemas.contacts.read, crm.objects.contacts.read, crm.lists.read

Connection

Establish a connection to your HubSpot CRM account.

List ID

Select the List ID whose contacts you want to watch.

Output Properties

Select the properties for which you want to watch the contacts.

Limit

The maximum number of contacts Make should return during one scenario execution cycle.

Deals

You can retrieve, and list the ticket pipelines using the following modules.

Returns all deal/ticket pipelines for a given portal.

Required Permissions: crm.objects.deals.read, tickets

Connection

Establish a connection to your HubSpot CRM account.

Object Type

Select the option you want to list:

  • Deals

  • Tickets

Returns a specific deal pipeline.

Required Permissions: crm.objects.deals.read

Connection

Establish a connection to your HubSpot CRM account.

Pipeline ID

Enter the Pipeline ID whose details you want to retrieve.

Stage ID

Enter the Stage ID whose details you want to retrieve.

Companies

You can search companies using the following module.

Retrieves a list of companies based on an exact match to the domain property.

Required Permissions: crm.schemas.companies.read, crm.objects.companies.read

Connection

Establish a connection to your HubSpot CRM account.

Domain

Enter the domain of the companies you want to search for. For example, hubspot.com.

Limit

The maximum number of companies Make will return during one scenario execution cycle.

Output Properties

Select the properties of the companies you want to search for.

Engagements

You can watch, create, and delete the engagements using the following modules.

Creates an engagement (a note task or activity) on an object in HubSpot Engagements are any interaction with a contact that should be logged inside of the CRM.

Required Permissions: crm.objects.owners.read, files, crm.objects.contacts.write, crm.objects.companies.write, crm.objects.deals.write

Connection

Establish a connection to your HubSpot CRM account.

Is Active?

Select if the engagement is active.

Type

Select the type of engagement you want to create:

  • Email

  • Call

  • Meeting

  • Task

  • Note

Timestamp

Enter the time when this engagement occurred.

Owner ID

Select the user who owns this engagement.

UID

Enter the unique ID of the engagement for reusing this across different types.

Portal ID

Enter the Hub ID of the target portal that is useful if you have access to multiple portals.

Associated Contacts

Add the Contact IDs associated with this engagement.

Associated Companies

Add the Company IDs associated with this engagement.

Associated Deals

Add the Deal IDs associated with this engagement.

Associated Tickets

Add the Ticket IDs associated with this engagement.

Attachments

Add the File IDs associated with this engagement.

Associates an engagement with a contact, company, or a deal.

Required Permissions: crm.objects.contacts.write, crm.objects.companies.write, crm.objects.deals.write

Connection

Establish a connection to your HubSpot CRM account.

Type

Select the option with which you want to associate the engagement.

  • Contact

  • Company

  • Deal

Engagement ID

Select the Engagement ID you want to associate with the company.

Record ID

Enter the Contact ID, Company ID or Deal ID you want to associate with the engagement.

Deletes an engagement (a task, or activity) on an object in HubSpot.

Required Permissions: crm.objects.contacts.write, crm.objects.companies.write, crm.objects.deals.write

Connection

Establish a connection to your HubSpot CRM account.

ID

Enter the Engagement ID you want to delete.

Triggers when a new engagement is created in a portal. This endpoint will only return records created in the last 30 days, or the 10k most recently created records.

Required Permissions: crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read, sales-email-read

Events and Notifications

You can watch, create, update, list the event and notifications using the following modules.

Creates or updates a timeline event. This module can be used only with a developer connection where your user identifier your HubSpot API Key, your Client ID, and Client Secret are filled in advanced parameters.

Required Permissions: timeline

Connection

Establish a connection to your HubSpot CRM account.

Application ID

Enter the ID of the OAuth app, created inside your HubSpot Developer portal.

Event ID

Enter the ID of the event you are creating. You need to specify your own event ID when creating an ID, it will not be assigned automatically.

Event Type ID

Enter the Event Type ID you are creating.

Email

Enter the email address of the user ID to whom you are assigning the event.

Retrieves a list of all timeline event types for a specific application. This module can be used only with a developer connection where your user identifier, your HubSpot API Key, your Client ID, and Client Secret a filled in advanced parameters.

Required Permissions: timeline

Connection

Establish a connection to your HubSpot CRM account.

Application ID

Enter the Application ID whose timeline event types you want to list.

Trigger when there is a new event in the calendar (only for users with the paid Marketing account). It works up to 500 tasks in the interval between the start date and the end date.

Required Permissions: content

Connection

Establish a connection to your HubSpot CRM account.

Event Type

Select the event type you want to watch:

  • All

  • Social

  • Content

Limit

Select the event type you want to watch:

Start Date

Enter the start date of the event. See the list of supported date and time formats.

End Date

Enter the end date of the event. See the list of supported date and time formats.

Triggers when a new notification about changes is sent. This module can be used only with a developer connection where your user identifier, your HubSpot API Key, your Client ID, and Client Secret are filled in advanced parameters. You can have only one webhook URL per 1 developer application. You can create more subscriptions for this one webhook.

Required Permissions: crm.objects.contacts.read

Files

You can create, delete folders, watch, create, move, upload, and delete files using the following modules.

Permanently deletes a file and all related data and thumbnails from the file manager.

Required Permissions: files

Connection

Establish a connection to your HubSpot CRM account.

File ID

Enter the File ID you want to delete.

Creates a folder.

Required Permissions: files

Connection

Establish a connection to your HubSpot CRM account.

Folder Name

Enter the folder name.

Parent Folder ID

Select the Parent Folder ID for the folder you are creating.

Marks a folder as deleted.

Required Permissions: files

Connection

Establish a connection to your HubSpot CRM account.

ID

Enter the Folder ID you want to delete.

Moves a file to a different folder.

Required Permissions: files

Connection

Establish a connection to your HubSpot CRM account.

File ID

Enter the File ID you want to move.

Folder ID

Select the Folder ID to which you want to move the file.

Name

Enter the file name.

Uploads a new file to the file manager.

Required Permissions: files

Connection

Establish a connection to your HubSpot CRM account.

Filename

Enter the file name with the extension that you want to upload. For example, sample.txt.

Data

Enter the path or map the file.

Folder ID

Select the Folder ID to which you want to upload the file.

Overwrite

Select if you want to overwrite any existing file.

Retrieves a list of files stored in the file manager.

Required Permissions: files

Connection

Establish a connection to your HubSpot CRM account.

Limit

The maximum number of files Make will return during one scenario execution cycle.

Folder ID

Select the Folder ID whose files you want to list.

Filter

Enter the keywords to filter the files with the characters or words.

Triggers when a new file is stored in the file manager.

Required Permissions: files

Connection

Establish a connection to your HubSpot CRM account.

Limit

The maximum number of files Make will return during one scenario execution cycle.

Folder ID

Select the Folder ID whose files you want to watch.

Filter

Enter the keywords to filter the files with the characters or words.

Tasks

You can watch, create, and delete the tasks using the following modules.

Creates a new task for the calendar (only for the paid Marketing account).

Required Permissions: content, crm.objects.owners.read

Connection

Establish a connection to your HubSpot CRM account.

Name

Enter a name for the task.

Description

Enter the details of the task.

Owner ID

Select the user to whom the task is assigned.

Event Date

Enter the date by when the task must be completed. See the list of supported date and time formats.

Category

Select the category for the task.

State

Select the status of the task:

  • Done

  • To Do

Campaign GUID

Enter a value of campaign GUID associated with the task.

Deletes a task from the system (only for users with the paid Marketing account).

Required Permissions: content

Connection

Establish a connection to your HubSpot CRM account.

ID

Enter the Task ID you want to delete.

Triggers when there is a new task event in the calendar (only for users with the paid Marketing account). It works up to 500 tasks in the interval between the start date and the end date.

Required Permissions: content

Connection

Establish a connection to your HubSpot CRM account.

Limit

The maximum number of task events Make will return during one scenario execution cycle.

Start Date

Enter the date from which you want to watch the tasks that are created on or after the specified date. See the list of supported date and time formats.

End Date

Enter the date until which you want to watch the tasks that are created on or before the specified date. See the list of supported date and time formats.

Users

You can retrieve and list the owners using the following modules.

Returns details for an owner.

Required Permissions: crm.objects.owners.read

Connection

Establish a connection to your HubSpot CRM account.

Owner ID

Enter the Owner ID whose details you want to retrieve.

List Owners

Returns all of the owners that exist inside of HubSpot.

Required Permissions: crm.objects.owners.read

Tickets

You can watch, create, update, list, retrieve, and delete the tickets using the following modules.

Creates a ticket.

Required Permissions: tickets

Connection

Establish a connection to your HubSpot CRM account.

Properties of Mode

Select the mode of the ticket you want to create.

Pipeline

Enter the Pipeline ID for the ticket is in.

Stage

Enter the Stage ID in the ticket's pipeline.

Category

Enter the category for the ticket.

Close date

Enter the date when the ticket is to be closed. See the list of supported date and time formats.

Create date

Enter the date when the ticket is created. See the list of supported date and time formats.

File upload

Enter the data or map for uploading the file.

Priority

Select the priority of the ticket:

  • High

  • Low

  • Medium

Resolution

Enter the details of the ticket resolution.

Source

Enter the details of the source from where the ticket is received.

Ticket Description

Enter the details of the ticket.

Ticket Name

Enter the name of the ticket.

Ticket Owner

Enter the user name to whom the ticket is assigned.

Updates an existing ticket by its ID.

Required Permissions: tickets, crm.objects.owners.read

Connection

Establish a connection to your HubSpot CRM account.

ID

Enter the Ticket ID you want to update.

Category

Enter the category to which the ticket belongs to.

Close date

Enter the date when the ticket must be closed. See the list of supported date and time formats.

Create date

Enter the date when the ticket is created. See the list of supported date and time formats.

File upload

Enter the data or map for uploading the file.

Priority

Select the priority of the ticket:

  • High

  • Low

  • Medium

Resolution

Enter the details of the ticket resolution.

Source

Enter the details of the source from where the ticket is received.

Ticket Description

Enter the details of the ticket.

Ticket Name

Enter the name of the ticket.

Ticket Owner

Enter the user name to whom the ticket is assigned.

Deletes an existing ticket by its ID.

Required Permissions: tickets

Connection

Establish a connection to your HubSpot CRM account.

ID

Enter the Ticket ID you want to delete.

Gets a specific ticket by its ID.

Required Permissions: tickets

Connection

Establish a connection to your HubSpot CRM account.

ID

Enter the Ticket ID whose details you want to retrieve.

Output Properties

Select the ticket properties whose details you want to retrieve.

Retrieves a list of tickets.

Required Permissions: tickets

Connection

Establish a connection to your HubSpot CRM account.

ID

Enter the Ticket ID whose details you want to list.

Output Properties

Select the ticket properties whose details you want to list.

Triggers when a new ticket is created.

Required Permissions: tickets

Connection

Establish a connection to your HubSpot CRM account.

Limit

The maximum number of tickets Make will return during one scenario execution cycle.

Output Properties

Select the ticket properties you want to watch.

Forms

You can watch form submissions, submit data to a form, upload a file through form using the following modules.

Sends form submission data to HubSpot.

Required Permissions: forms

Connection

Establish a connection to your HubSpot CRM account.

Form ID

Select the Form ID to which you want to submit the data.

Portal ID

Enter the HubSpot Portal ID to which the data belongs.

Email

Enter the user email address who is submitting the form.

Firstname

Enter (map) the first name of the user who is submitting the form.

Lastname

Enter (map) the last name of the user who is submitting the form.

Page Name

Enter the name or title of the form page.

Page URL

Enter the website URL of the form page.

HubSpot Tracking Cookie

Enter the tracking token value used for HubSpot lead activity.

For a given file ID, returns the file associated with that ID.

Required Permissions: forms-uploaded-files

Connection

Establish a connection to your HubSpot CRM account.

File URL

Enter (map) the URL address of the file you want to upload to the form.

Retrieves a list of forms for a given portal.

Required Permissions: forms

Connection

Establish a connection to your HubSpot CRM account.

Limit

The maximum number of forms Make will return during one scenario execution cycle.

Triggers when data is submitted from a given form.

Required Permissions: forms

Connection

Establish a connection to your HubSpot CRM account.

Limit

The maximum number of form submissions Make should return during one scenario execution cycle.

Form ID

Select the Form ID whose submissions you want to watch.

Return Multiple Values Concated to Text

When selected, you can enter multiple or select multiple values in certain field types. This field returns submitted values in a single text block separated by the delimiter of your choice.

Delimiter

Enter the values such as comma (,), semicolon (;), braces ({}) for which you want to watch the forms.

Social Media (Broadcast)

You can watch, create, and cancel broadcast messages using the following modules.

Creates and immediately publishes a message on a specified social media channel.

Required Permissions: social

Connection

Establish a connection to your HubSpot CRM account.

Channel ID

Select or map the Channel ID whose broadcast message you want to create.

Title

Enter (map) a name for the message.

Body

Enter (map) the text message for the message text.

Photo URL

Enter (map) the image URL address you want to add to the message.

Thumbnail URL

Enter (map) the

Triggers at

Enter (map) the time you want to publish the message. See the list of supported date and time formats.

Cancels a scheduled broadcast (e.g. tweet or Facebook post).

Required Permissions: social

Connection

Establish a connection to your HubSpot CRM account.

Broadcast ID

Select or map the Broadcast ID you want to cancel.

Triggers when a message is posted from HubSpot to the specified social media channel.

Required Permissions: social

Connection

Establish a connection to your HubSpot CRM account.

Limit

Set the maximum number of broadcast messages Make should return during one execution cycle.

Filter by Status

Select or map the option to filter the messages that match the specified filter. For example, success, and waiting.

Filter by Channel

Select or map the channel to filter the messages that match the

Filter by Trigger Timestamp Value

Enter (map) the time to receive the triggers about the message created or published at the specified time. See the list of supported date and time formats.

Blog Posts

You can create, list, and delete the blog posts using the following modules.

Creates a new blog post.

Required Permissions: content

Connection

Establish a connection to your HubSpot CRM account.

Name

Enter the name of the post title.

Post Body

Enter the HTML content of the main post body.

Post Summary

Enter the summary of the blog post that appears on the main listing page.

Blog Author ID

Select the ID of the blog author.

Content Group ID

Select the Content Group ID of the blog that which this post belongs.

Footer HTML

Enter custom HTML for embed codes, and JavaScript that should be placed before the </body> tag of the page.

Head HTML

Enter custom HTML for embed codes, JavaScript, etc. that go in the <head> tag of the page.

Deletes a blog post.

Required Permissions: content

Connection

Establish a connection to your HubSpot CRM account.

ID

Enter (map) the Blog Post ID you want to delete.

Retrieves a list of blog posts.

Required Permissions: content

Connection

Establish a connection to your HubSpot CRM account.

Limit

The maximum number of blog posts Make will return during one scenario execution cycle.

Archived

Select Yes if want to list all the posts that are currently (NOT) archived:

  • Yes

  • No

Blog Author ID

Select the Blog Author ID whose posts you want to list.

Campaign ID

Select the Campaign ID whose posts you want to list.

Name

Enter the name of the blog post you want to list.

Filter by Created

Select the filter to list the posts by created time.

Created

Enter the date for which you want to list the posts.

Lookup (Created)

Select the option to list the posts by their created time:

  • Range

  • Later Than

  • Later Than or Equal

  • Earlier Than

  • Earlier Than or Equal

Filter by Updated

Enter the filter to list the posts by their updated time.

Updated

Enter the date for which you want to list the updated posts.

Lookup (Updated)

Select the option to list the posts by their updated time:

  • Range

  • Later Than

  • Later Than or Equal

  • Earlier Than

  • Earlier Than or Equal

Filter by Deleted

Enter the filter to list the posts by their deleted time.

Deleted

Enter the date to list the posts.

Lookup (Deleted)

Select the option to list the posts by their deleted time:

  • Range

  • Later Than

  • Later Than or Equal

  • Earlier Than

  • Earlier Than or Equal

Slug

Enter a name to return the posts that match the slug value.

State

Select a state to return the posts that match the state value:

  • Draft

  • Published

  • Scheduled

Order by Publish Date

Select the order to list the result by publishing date:

  • Ascending Order

  • Descending Order

Workflows

You can add contacts to a workflow using the workflow modules.

Adds a contact to a specific workflow.

Required Permissions: automation

Connection

Establish a connection to your HubSpot CRM account.

Email

Enter the email address of the contact you want to add to the workflow.

Workflow

Select the Workflow ID to which you want to add the contact.

Subscriptions

You can watch subscription timeline for a portal and update the email subscriptions using the following module.

Triggers when a new email timeline subscription is added to a portal.

Required Permissions: content

Connection

Establish a connection to your HubSpot CRM account.

Limit

The maximum number of subscriptions Make should return during one scenario execution cycle.

Start Timestamp

Enter the timestamp to watch the subscriptions that occurred on or after the given timestamp.

End Timestamp

Enter the timestamp to watch the subscriptions that occurred on or before the given timestamp.

Updates email subscription.

Required Permissions: content

Connection

Establish a connection to your HubSpot CRM account.

Emails

Enter the email address whose subscription you want to update.

Statuses

Add the statuses for subscription: ID Enter the subscription ID.

Subscribed

Select if the email address is subscribed.

Opted IN/OUT

Select whether the subscription is opted in:

  • OPT IN

  • OPT OUT

  • Not Opted

Legal Basis

Select the legal basis option for the subscription.

Legal Basis Explanation

Enter the details of the legal basis.

Portal Subscription Legal Basis

Select the legal basis option for the subscription.

Portal Subscription Legal Basis Explanation

Enter the details of the legal basis.

Associations

You can associate CRM objects, list, and delete the associations using the following modules.

Deletes an association between two CRM objects.

Required Permissions: crm.objects.contacts.write, crm.objects.companies.write, crm.objects.deals.write

Connection

Establish a connection to your HubSpot CRM account.

From Object ID

Select or map the Object ID whose association you want to delete with another object.

To Object ID

Select or map the Object ID with which you want to delete the association for the above-selected object.

Definition ID

Select or map the association between two objects.

Associate two CRM objects.

Required Permissions: crm.objects.contacts.write, crm.objects.companies.write, crm.objects.deals.write

Connection

Establish a connection to your HubSpot CRM account.

From Object ID

Select or map the Object ID which you want to associate with another object.

To Object ID

Select or map the Object ID with which you want to associate the above-selected object.

Definition ID

Select or map the association between two objects.

Return the IDs of CRM objects associated with a given object, based on the specified association type.

Required Permissions: crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read

Connection

Establish a connection to your HubSpot CRM account.

Limit

Set the maximum number of associations Make will return during one execution cycle.

Object ID

Select or map the Object ID whose associations you want to list.

Definition ID

Select or map the association between two objects.

Creates multiple associations between CRM objects.

Required Permissions: crm.objects.contacts.write, crm.objects.companies.write, crm.objects.deals.write

Connection

Establish a connection to your HubSpot CRM account.

Associations

Add the objects for the association:

  • From Object ID Select or map the Object ID which you want to associate with another object.

  • To Object ID Select or map the Object ID with which you want to associate the above-selected object.

  • Definition ID Select or map the association between two objects.

Deletes multiple associations between CRM objects.

Required Permissions: crm.objects.contacts.write, crm.objects.companies.write, crm.objects.deals.write

Connection

Establish a connection to your HubSpot CRM account.

Associations

Add the objects for the association:

  • From Object ID: Select or map the Object ID whose association you want to delete.

  • To Object ID: Select or map the Object ID with which you want to delete the association.

  • Definition ID: Select or map the association between two objects.

Other

You can make API calls using this module.

Make an API Call

Allows you to perform a custom API call.

Connection

Establish a connection to your HubSpot CRM account.

URL

Enter a path relative to https://api.hubapi.com/. For example, /contacts/v1/lists/all/contacts/all.

For the list of available endpoints, refer to the HubSpot API Documentation.

Method

Select the HTTP method you want to use:

  • GET

    to retrieve information for an entry.

  • POST

    to create a new entry.

  • PUT

    to update/replace an existing entry.

  • PATCH

    to make a partial entry update.

  • DELETE

    to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - List All Contacts

The following API call returns all contacts in your HubSpot account:

URL:

/contacts/v1/lists/all/contacts/all

Method:

GET

61d6a3081e335.png

Matches of the search can be found in the module's Output under Bundle > Body > contacts.

In our example, 3 contacts were returned:

61d6a308f0710.png

Disconnecting Make with HubSpot CRM

To disconnect Make app:

  1. Log in to your HubSpot Developer account.

  2. Click App Marketplace > App Marketplace > Manage Apps.

    msedge_l7k6OsRWQy.png
  3. Under the Connected apps section, in the app you want to disconnect, click Actions > Uninstall.

    msedge_ud9oqiNHZD.png

The app gets disconnected successfully.