Skip to content
TriggerHubSpotReal-timeUpdated May 2026

How do I trigger when a new message is posted in HubSpot Conversations?

Short answer: Drop the "HubSpotNew Conversation Message" trigger on your workflow canvas, add filters if you want them, and publish. It fires within seconds of the event in HubSpot, not on a polling schedule.

Anatomy

What this trigger looks like in a workflow.

Drop it on the canvas. Configure a couple of fields. Publish.

In the builder
Trigger
New Conversation Message
When the matching event happens
new conversation messagenew chat messageon new messagewatch for new messageinbox message receivedwhen a message is posted in hubspot conversations
What this trigger returns
for the curious

You don’t need to read this. Tiny Command auto-maps every field into the visual picker so downstream nodes can pull values by clicking. We show it here for power users who want to know what’s on the wire.

{
"eventId": 100,
"objectId": 1234567,
"portalId": 62515,
"sourceId": "userId:12345",
"occurredAt": 1712835600000,
"changeSource": "CRM",
"propertyName": "",
"attemptNumber": 0,
"propertyValue": "",
"subscriptionId": 12345,
"subscriptionType": "conversation.newMessage"
}
Output shape

Fields available to downstream nodes.

Every field below can be referenced by name in any action or filter that comes after this trigger.

FieldTypeExample
eventIdnumber100
objectIdnumber1234567
portalIdnumber62515
sourceIdstring"userId:12345"
occurredAtnumber1712835600000
changeSourcestring"CRM"
propertyNamestring""
attemptNumbernumber0
propertyValuestring""
subscriptionIdnumber12345
subscriptionTypestring"conversation.newMessage"
FAQ

Questions about New Conversation Message.

How does the New Conversation Message trigger work in HubSpot?
Fires when a new message is posted to a conversation thread in HubSpot Conversations Inbox. The hook for chatbots, auto-replies, or routing on inbound replies.
Is the New Conversation Message trigger real-time?
Yes. New Conversation Message uses webhooks or push subscriptions, not polling. Your workflow fires within seconds of the event happening in HubSpot.
What data does New Conversation Message return?
The full event payload from HubSpot. The output shape table on this page lists every field, its type, and an example value so you can map fields into downstream nodes.
Can I filter New Conversation Message so only some events start a workflow?
Yes. Add a Filter node right after the trigger and match on any field, whether that's subject, sender, status, or anything else in the payload. Workflows only continue when the filter passes.
Do I need HubSpot admin permissions to use New Conversation Message?
For most HubSpot accounts a standard user can authorize the trigger. Some HubSpot plans require an admin to enable third-party webhooks. Check HubSpot's docs if the trigger fails to register.
More triggers

Other HubSpot triggers.

Build a workflow on this trigger.

One trigger. 23+ downstream actions. Zero glue.