---
title: HubSpot
description: Available HubSpot triggers for automating workflows
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard
  type="hubspot"
  color="#FF7A59"
/>

HubSpot provides 1 trigger for automating workflows based on events.

All triggers below are **polling-based** — they check for new data on a schedule rather than receiving push notifications.

## Triggers

### HubSpot Trigger

Triggers when a HubSpot record (contact, company, deal, ticket, or custom object) is created or updated

#### Configuration

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `triggerCredentials` | string | Yes | Connect a HubSpot account so Sim can poll your CRM on your behalf. |
| `objectType` | string | Yes | Which HubSpot CRM object to watch. Pick  |
| `customObjectTypeId` | string | Yes | HubSpot custom object type ID \(e.g.  |
| `eventType` | string | Yes | Created fires once per new record. Updated fires whenever the record changes \(and on creation\). |
| `properties` | string | No | Comma- or newline-separated list of HubSpot property names to include on each record. Leave empty to use sensible defaults. Sim always includes the timestamp properties Sim needs internally, regardless of this list. |
| `filterPropertyName` | string | No | Only emit records where this property equals the value below. Leave both fields empty to emit every change. |
| `filterPropertyValue` | string | No | Value the filter property must match \(exact match, case-sensitive\). |
| `maxRecordsPerPoll` | string | No | Cap on records emitted per poll \(default 50, max 1000\). Excess rolls over to the next poll. |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `objectType` | string | HubSpot object type that fired the trigger \(contact, company, deal, ticket, or custom object type ID\) |
| `eventType` | string | Event type that fired the trigger \(created or updated\) |
| `objectId` | string | HubSpot ID of the affected record |
| `occurredAt` | string | ISO timestamp of the create or update on the record \(sourced from the relevant HubSpot timestamp property\) |
| `properties` | json | HubSpot properties returned for the record \(object of property name to value\) |
| `createdAt` | string | ISO timestamp when the record was created in HubSpot |
| `updatedAt` | string | ISO timestamp when the record was last updated in HubSpot |
| `archived` | boolean | Whether the record is archived |
| `timestamp` | string | ISO timestamp when Sim emitted the event |

