HubSpot

HubSpot CRM and marketing — contacts, deals, companies, and engagement tracking.

Overview

Property	Value
Type	http
Authentication	oauth2
Category	CRM & Sales

Configuration

Field	Type	Required	Description
client_id	string	Yes	HubSpot OAuth2 client ID
client_secret	string	Yes	HubSpot OAuth2 client secret

Available actions

Create Contact

Create a new contact in HubSpot CRM.

Endpoint	POST /crm/v3/objects/contacts
Method	POST

Update Contact

Update properties on an existing contact.

Endpoint	PATCH /crm/v3/objects/contacts/{contactId}
Method	PATCH

Get Contact

Retrieve a single contact by ID.

Endpoint	GET /crm/v3/objects/contacts/{contactId}
Method	GET

Search Contacts

Search contacts using filters, query strings, and sorting.

Endpoint	POST /crm/v3/objects/contacts/search
Method	POST

Create Deal

Create a new deal in the sales pipeline.

Endpoint	POST /crm/v3/objects/deals
Method	POST

Update Deal

Update properties on an existing deal.

Endpoint	PATCH /crm/v3/objects/deals/{dealId}
Method	PATCH

Create Company

Create a new company record.

Endpoint	POST /crm/v3/objects/companies
Method	POST

List Pipelines

List all deal pipelines and their stages.

Endpoint	GET /crm/v3/pipelines/deals
Method	GET

Example flow

name: shopify-order-to-hubspot
trigger:
  type: webhook
  source: shopify
  event: orders/create

steps:
  - name: find-existing-contact
    connector: hubspot
    action: search-contacts
    input:
      filterGroups:
        - filters:
            - propertyName: email
              operator: EQ
              value: "{{ trigger.body.customer.email }}"

  - name: upsert-contact
    connector: hubspot
    action: create-contact
    skip_if: "{{ steps.find-existing-contact.output.total > 0 }}"
    input:
      properties:
        email: "{{ trigger.body.customer.email }}"
        firstname: "{{ trigger.body.customer.first_name }}"
        lastname: "{{ trigger.body.customer.last_name }}"
        phone: "{{ trigger.body.customer.phone }}"

  - name: create-deal
    connector: hubspot
    action: create-deal
    input:
      properties:
        dealname: "Shopify Order #{{ trigger.body.order_number }}"
        amount: "{{ trigger.body.total_price }}"
        dealstage: "closedwon"
        pipeline: "default"