Skip to Content

HubSpot

Engine64 can sync every captured lead into HubSpot as a contact. Each lead is created or updated (deduplicated by email address), so a returning visitor updates their existing contact instead of creating a duplicate. The conversation summary and a link to the conversation land on the contact’s message property.

This integration currently syncs the lead_captured event only.

Setup

  1. In HubSpot, open Settings → Integrations → Private Apps and click Create a private app.
  2. Under Scopes, grant crm.objects.contacts.read and crm.objects.contacts.write.
  3. Create the app and copy its access token.
  4. In Engine64, open the agent’s Webhooks page, find the HubSpot card, paste the token, and click Connect. Engine64 validates the token immediately, so a bad or under-scoped token is rejected on the spot.
  5. On the new row in the Configured Webhooks list, click Send test to push a sample contact into HubSpot.

Field mapping

Lead fieldHubSpot property
emailemail (deduplication key)
namefirstname / lastname
phonephone
message + conversation linkmessage

The name is split on the first space: the first word becomes firstname and the remainder becomes lastname. Empty fields are skipped rather than sent as blank values, so an update never wipes existing data on the contact.

Notes

v1 uses a HubSpot private app token and attaches the conversation summary to the contact’s message property. Timeline notes and engagements are a future enhancement. The underlying event and payload shape are documented in the webhook envelope reference.

Last updated on
Engine64 | Docs