HubSpot Integration — ModuleX AI

Overview

Add HubSpot to any ModuleX agent or workflow. HubSpot CRM integration via the synchronous hubspot-api-client SDK. 26 actions across contacts, companies, deals, tickets, plus engagement (note/task/meeting) and property management.

Categories: CRM · Sales · Marketing · Auth: OAuth2, Private App Access Token · Actions: 26

Authentication

OAuth2
Private App Access Token

OAuth2 Authentication

Connect using HubSpot OAuth (recommended for most use cases)

Required Credentials

Field	Description	Required	Format
Client ID	HubSpot OAuth App Client ID	Yes	`xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`
Client Secret	HubSpot OAuth App Client Secret	Yes	`xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`

OAuth Configuration

Authorization URL: https://app.hubspot.com/oauth/authorize
Token URL: https://api.hubapi.com/oauth/v1/token
Scopes: crm.objects.contacts.read, crm.objects.contacts.write, crm.objects.companies.read, crm.objects.companies.write, crm.objects.deals.read, crm.objects.deals.write, tickets, crm.schemas.contacts.read, crm.schemas.companies.read, crm.schemas.deals.read

Private App Access Token

Use a HubSpot Private App access token for authentication

Required Credentials

Field	Description	Required	Format
Access Token	HubSpot Private App access token	Yes	`pat-eu1-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`

Available Actions

get_recent_contacts — List recently modified contacts (sort: lastmodifieddate DESC)

Parameters

integer

Maximum results to return (Default: 10)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "contacts": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Contacts",
      "type": "array"
    },
    "total": {
      "default": 0,
      "title": "Total",
      "type": "integer"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetRecentContactsOutput",
  "type": "object"
}

get_contact_by_id — Retrieve a contact by its HubSpot ID

Parameters

string

required

HubSpot contact ID

array

Properties to retrieve (None = default property set)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "result": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Result"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetContactByIdOutput",
  "type": "object"
}

create_contact — Create a new contact (email required)

Parameters

string

required

Contact email address

string

First name

string

Last name

string

Phone number

string

Company

string

Website URL

object

Additional properties to set

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "result": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Result"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateContactOutput",
  "type": "object"
}

update_contact — Update a contact's properties

Parameters

string

required

HubSpot contact ID

object

required

Properties to update

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "result": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Result"
    }
  },
  "required": [
    "success"
  ],
  "title": "UpdateContactOutput",
  "type": "object"
}

search_contacts — Search contacts by query string

Parameters

string

required

Search query string

integer

Maximum results to return (Default: 10)

array

Properties to retrieve (None = default property set)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "contacts": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Contacts",
      "type": "array"
    },
    "total": {
      "default": 0,
      "title": "Total",
      "type": "integer"
    }
  },
  "required": [
    "success"
  ],
  "title": "SearchContactsOutput",
  "type": "object"
}

get_recent_companies — List recently modified companies

Parameters

integer

Maximum results to return (Default: 10)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "companies": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Companies",
      "type": "array"
    },
    "total": {
      "default": 0,
      "title": "Total",
      "type": "integer"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetRecentCompaniesOutput",
  "type": "object"
}

get_company_by_id — Retrieve a company by its HubSpot ID

Parameters

string

required

HubSpot company ID

array

Properties to retrieve (None = default property set)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "result": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Result"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetCompanyByIdOutput",
  "type": "object"
}

create_company — Create a new company (name required)

Parameters

string

required

Company name

string

Primary domain

string

Industry

string

Phone number

string

Website URL

object

Additional properties

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "result": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Result"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateCompanyOutput",
  "type": "object"
}

update_company — Update a company's properties

Parameters

string

required

HubSpot company ID

object

required

Properties to update

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "result": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Result"
    }
  },
  "required": [
    "success"
  ],
  "title": "UpdateCompanyOutput",
  "type": "object"
}

get_company_activity — Get the engagement history for a company (N+1: list associations, then GET each engagement)

Parameters

string

required

HubSpot company ID

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "activities": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Activities",
      "type": "array"
    },
    "total": {
      "default": 0,
      "title": "Total",
      "type": "integer"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetCompanyActivityOutput",
  "type": "object"
}

search_companies — Search companies by query string

Parameters

string

required

Search query string

integer

Maximum results to return (Default: 10)

array

Properties to retrieve (None = default property set)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "companies": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Companies",
      "type": "array"
    },
    "total": {
      "default": 0,
      "title": "Total",
      "type": "integer"
    }
  },
  "required": [
    "success"
  ],
  "title": "SearchCompaniesOutput",
  "type": "object"
}

get_recent_deals — List recently modified deals

Parameters

integer

Maximum results to return (Default: 10)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "deals": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Deals",
      "type": "array"
    },
    "total": {
      "default": 0,
      "title": "Total",
      "type": "integer"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetRecentDealsOutput",
  "type": "object"
}

get_deal_by_id — Retrieve a deal by its HubSpot ID

Parameters

string

required

HubSpot deal ID

array

Properties to retrieve (None = default property set)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "result": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Result"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetDealByIdOutput",
  "type": "object"
}

create_deal — Create a new deal (dealname required)

Parameters

string

required

Deal name

string

Pipeline ID

string

Stage ID

number

Deal amount

string

Expected close date (ISO 8601)

object

Additional properties

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "result": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Result"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateDealOutput",
  "type": "object"
}

update_deal — Update a deal's properties

Parameters

string

required

HubSpot deal ID

object

required

Properties to update

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "result": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Result"
    }
  },
  "required": [
    "success"
  ],
  "title": "UpdateDealOutput",
  "type": "object"
}

search_deals — Search deals by query string

Parameters

string

required

Search query string

integer

Maximum results to return (Default: 10)

array

Properties to retrieve (None = default property set)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "deals": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Deals",
      "type": "array"
    },
    "total": {
      "default": 0,
      "title": "Total",
      "type": "integer"
    }
  },
  "required": [
    "success"
  ],
  "title": "SearchDealsOutput",
  "type": "object"
}

get_recent_tickets — List recently modified tickets

Parameters

integer

Maximum results to return (Default: 10)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "tickets": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Tickets",
      "type": "array"
    },
    "total": {
      "default": 0,
      "title": "Total",
      "type": "integer"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetRecentTicketsOutput",
  "type": "object"
}

get_ticket_by_id — Retrieve a ticket by its HubSpot ID

Parameters

string

required

HubSpot ticket ID

array

Properties to retrieve (None = default property set)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "result": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Result"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetTicketByIdOutput",
  "type": "object"
}

create_ticket — Create a new support ticket (subject required)

Parameters

string

required

Ticket subject

string

Ticket content

string

Pipeline ID

string

Pipeline stage ID

string

LOW / MEDIUM / HIGH

object

Additional properties

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "result": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Result"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateTicketOutput",
  "type": "object"
}

update_ticket — Update a ticket's properties

Parameters

string

required

HubSpot ticket ID

object

required

Properties to update

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "result": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Result"
    }
  },
  "required": [
    "success"
  ],
  "title": "UpdateTicketOutput",
  "type": "object"
}

search_tickets — Search tickets by query string

Parameters

string

required

Search query string

integer

Maximum results to return (Default: 10)

array

Properties to retrieve (None = default property set)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "tickets": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Tickets",
      "type": "array"
    },
    "total": {
      "default": 0,
      "title": "Total",
      "type": "integer"
    }
  },
  "required": [
    "success"
  ],
  "title": "SearchTicketsOutput",
  "type": "object"
}

create_note — Create a note engagement (optionally associated with objects)

Parameters

string

required

Note body content

array

Contact IDs to associate

array

Company IDs to associate

array

Deal IDs to associate

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "result": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Result"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateNoteOutput",
  "type": "object"
}

create_task — Create a task engagement (subject required)

Parameters

string

required

Task subject

string

Task body

string

Due date (ISO 8601)

string

Priority (NONE/LOW/MEDIUM/HIGH) (Default: NONE)

string

Status (NOT_STARTED/IN_PROGRESS/COMPLETED/etc.) (Default: NOT_STARTED)

array

Contact IDs to associate

array

Company IDs to associate

array

Deal IDs to associate

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "result": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Result"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateTaskOutput",
  "type": "object"
}

create_meeting — Create a meeting engagement

Parameters

string

required

Meeting title

string

required

Start time (ISO 8601 or epoch ms)

string

required

End time

string

Meeting body

array

Contact IDs to associate

array

Company IDs to associate

array

Deal IDs to associate

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "result": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Result"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateMeetingOutput",
  "type": "object"
}

get_property — Get a single property definition by name

Parameters

string

required

One of contacts/companies/deals/tickets

string

required

Property name to retrieve

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "result": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Result"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetPropertyOutput",
  "type": "object"
}

list_properties — List all property definitions for an object type

Parameters

string

required

One of contacts/companies/deals/tickets

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "properties": {
      "type": "array",
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Properties"
    },
    "total": {
      "default": 0,
      "title": "Total",
      "type": "integer"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListPropertiesOutput",
  "type": "object"
}

​Overview

​Authentication

​OAuth2 Authentication

​Required Credentials

​OAuth Configuration

​Private App Access Token

​Required Credentials

​Available Actions

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Related integrations

Clay

Dropcontact

Insightly

​Links

Overview

Authentication

OAuth2 Authentication

Required Credentials

OAuth Configuration

Private App Access Token

Required Credentials

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Related integrations

Links