HubSpot provides 28 triggers for automating workflows based on events.
Some triggers below are polling-based (checked on a schedule) while others are push-based webhooks.
Trigger workflow when a new company is created in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Trigger workflow when a company is deleted in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Trigger workflow when companies are merged in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing merge event details |
↳ objectId | number | HubSpot object ID (winning/primary record) |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ mergedObjectIds | array | IDs of the objects that were merged into the primary record |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_contact_merged) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
Trigger workflow when any property of a company is updated in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
propertyName | string | No | Optional: Filter to only trigger when a specific property changes. Leave empty to trigger on any property change. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Trigger workflow when a deleted company is restored in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Trigger workflow when a new contact is created in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Trigger workflow when a contact is deleted in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Trigger workflow when contacts are merged in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing merge event details |
↳ objectId | number | HubSpot object ID (winning/primary record) |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ mergedObjectIds | array | IDs of the objects that were merged into the primary record |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_contact_merged) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
Trigger workflow when a contact is deleted for privacy compliance (GDPR, CCPA, etc.) in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Trigger workflow when any property of a contact is updated in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
propertyName | string | No | Optional: Filter to only trigger when a specific property changes. Leave empty to trigger on any property change. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Trigger workflow when a deleted contact is restored in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Trigger workflow when a new conversation is created in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Trigger workflow when a conversation is deleted in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Trigger workflow when a new message is added to a conversation in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Trigger workflow when a conversation is deleted for privacy compliance (GDPR, CCPA, etc.) in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Trigger workflow when any property of a conversation is updated in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
propertyName | string | No | Optional: Filter to only trigger when a specific property changes. Leave empty to trigger on any property change. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Triggers when HubSpot CRM records (contacts, companies, deals, tickets, custom objects) are created or updated, or when contacts join a list
| Parameter | Type | Description |
|---|
objectType | string | HubSpot object type (contact, company, deal, ticket, custom object id, or list_membership) |
eventType | string | Event type (created, updated, property_changed, or joined) |
objectId | string | HubSpot ID of the affected record (or contact id for list memberships) |
occurredAt | string | ISO timestamp of when the change happened in HubSpot |
properties | json | HubSpot properties on the record as a key-value object (property internal name → value). Default keys per object type (override via "Properties to Fetch"): Contact → firstname, lastname, email, phone, company, lifecyclestage, hs_lead_status, hubspot_owner_id, createdate, lastmodifieddate. Company → name, domain, industry, lifecyclestage, hubspot_owner_id, createdate, hs_lastmodifieddate. Deal → dealname, amount, dealstage, pipeline, closedate, hubspot_owner_id, createdate, hs_lastmodifieddate. Ticket → subject, content, hs_pipeline, hs_pipeline_stage, hs_ticket_priority, hubspot_owner_id, createdate, hs_lastmodifieddate. Custom and user-requested properties appear keyed by their HubSpot internal name. |
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 |
propertyName | string | Name of the property that changed (property_changed events only) |
propertyValue | string | New value of the changed property (property_changed events only) |
previousValue | string | Previous value before the change (property_changed events only) |
listId | string | HubSpot list ID (list_membership events only) |
timestamp | string | ISO timestamp when AptlyStar emitted the event |
Trigger workflow when a new deal is created in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Trigger workflow when a deal is deleted in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Trigger workflow when deals are merged in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing merge event details |
↳ objectId | number | HubSpot object ID (winning/primary record) |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ mergedObjectIds | array | IDs of the objects that were merged into the primary record |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_contact_merged) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
Trigger workflow when any property of a deal is updated in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
propertyName | string | No | Optional: Filter to only trigger when a specific property changes. Leave empty to trigger on any property change. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Trigger workflow when a deleted deal is restored in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Trigger workflow when a new ticket is created in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Trigger workflow when a ticket is deleted in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Trigger workflow when tickets are merged in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing merge event details |
↳ objectId | number | HubSpot object ID (winning/primary record) |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ mergedObjectIds | array | IDs of the objects that were merged into the primary record |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_contact_merged) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
Trigger workflow when any property of a ticket is updated in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
propertyName | string | No | Optional: Filter to only trigger when a specific property changes. Leave empty to trigger on any property change. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Trigger workflow when a deleted ticket is restored in HubSpot
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |
Trigger workflow on any HubSpot webhook event
| Parameter | Type | Required | Description |
|---|
clientId | string | Yes | Found in your HubSpot app settings under Auth tab |
clientSecret | string | Yes | Found in your HubSpot app settings under Auth tab |
appId | string | Yes | Found in your HubSpot app settings. Used to identify your app. |
developerApiKey | string | Yes | Used for making API calls to HubSpot. Found in your HubSpot app settings. |
| Parameter | Type | Description |
|---|
payload | array | Full webhook payload array from HubSpot containing event details |
↳ objectId | number | HubSpot object ID |
↳ subscriptionType | string | Type of subscription event |
↳ portalId | number | HubSpot portal ID |
↳ occurredAt | number | Timestamp when event occurred (ms) |
↳ attemptNumber | number | Webhook delivery attempt number |
↳ eventId | number | Event ID |
↳ changeSource | string | Source of the change |
↳ propertyName | string | Property name (for propertyChange events) |
↳ propertyValue | string | New property value (for propertyChange events) |
provider | string | Provider name (hubspot) |
providerConfig | object | Provider configuration |
↳ appId | string | HubSpot App ID |
↳ clientId | string | HubSpot Client ID |
↳ triggerId | string | Trigger ID (e.g., hubspot_company_created) |
↳ clientSecret | string | HubSpot Client Secret |
↳ developerApiKey | string | HubSpot Developer API Key |
↳ curlSetWebhookUrl | string | curl command to set webhook URL |
↳ curlCreateSubscription | string | curl command to create subscription |
↳ webhookUrlDisplay | string | Webhook URL display value |
↳ propertyName | string | Optional property name filter (for property change triggers) |